shell: Convert the filesystem shell folder to Unicode.
[wine/multimedia.git] / dlls / shell32 / pidl.h
blob691aa2aa51f2fcd62a65717aa337d04329ef98a5
1 /*
2 * internal pidl functions
4 * Copyright 1998 Juergen Schmied
5 * Copyright 2004 Juan Lang
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with this library; if not, write to the Free Software
19 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
21 * NOTES:
23 * DO NOT use this definitions outside the shell32.dll !
25 * The contents of a pidl should never used from a application
26 * directly.
28 * Undocumented:
29 * MS says: the abID of SHITEMID should be treated as binary data and not
30 * be interpreted by applications. Applies to everyone but MS itself.
31 * Word95 interprets the contents of abID (Filesize/Date) so we have to go
32 * for binary compatibility here.
35 #ifndef __WINE_PIDL_H
36 #define __WINE_PIDL_H
38 #include <stdarg.h>
40 #include "windef.h"
41 #include "winbase.h"
42 #include "winuser.h"
43 #include "shlobj.h"
46 * the pidl does cache fileattributes to speed up SHGetAttributes when
47 * displaying a big number of files.
49 * a pidl of NULL means the desktop
51 * The structure of the pidl seems to be a union. The first byte of the
52 * PIDLDATA desribes the type of pidl.
54 * object ! first byte / ! format ! living space
55 * ! size
56 * ----------------------------------------------------------------
57 * my computer 0x1F/20 guid (2) (usual)
58 * network 0x1F guid
59 * bitbucket 0x1F guid
60 * drive 0x23/25 drive (usual)
61 * drive 0x25/25 drive (lnk/persistent)
62 * drive 0x29/25 drive
63 * shell extension 0x2E guid
64 * drive 0x2F drive (lnk/persistent)
65 * folder/file 0x30 folder/file (1) (lnk/persistent)
66 * folder 0x31 folder (usual)
67 * valueA 0x32 file (ANSI file name)
68 * valueW 0x34 file (Unicode file name)
69 * workgroup 0x41 network (3)
70 * computer 0x42 network (4)
71 * net provider 0x46 network
72 * whole network 0x47 network (5)
73 * MSITStore 0x61 htmlhlp (7)
74 * printers/ras connections 0x70 guid
75 * history/favorites 0xb1 file
76 * share 0xc3 network (6)
78 * guess: the persistent elements are non tracking
80 * (1) dummy byte is used, attributes are empty
81 * (2) IID_MyComputer = 20D04FE0L-3AEA-1069-A2D8-08002B30309D
82 * (3) two strings "workgroup" "Microsoft Network"
83 * (4) two strings "\\sirius" "Microsoft Network"
84 * (5) one string "Entire Network"
85 * (6) two strings "\\sirius\c" "Microsoft Network"
86 * (7) contains string "mk:@MSITStore:C:\path\file.chm::/path/filename.htm"
87 * GUID 871C5380-42A0-1069-A2EA-08002B30309D
90 #define PT_CPLAPPLET 0x00
91 #define PT_GUID 0x1F
92 #define PT_DRIVE 0x23
93 #define PT_DRIVE2 0x25
94 #define PT_DRIVE3 0x29
95 #define PT_SHELLEXT 0x2E
96 #define PT_DRIVE1 0x2F
97 #define PT_FOLDER1 0x30
98 #define PT_FOLDER 0x31
99 #define PT_VALUE 0x32
100 #define PT_VALUEW 0x34
101 #define PT_WORKGRP 0x41
102 #define PT_COMP 0x42
103 #define PT_NETPROVIDER 0x46
104 #define PT_NETWORK 0x47
105 #define PT_IESPECIAL1 0x61
106 #define PT_YAGUID 0x70 /* yet another guid.. */
107 #define PT_IESPECIAL2 0xb1
108 #define PT_SHARE 0xc3
110 #include "pshpack1.h"
111 typedef BYTE PIDLTYPE;
113 typedef struct tagPIDLCPanelStruct
115 BYTE dummy; /*01 is 0x00 */
116 DWORD iconIdx; /*02 negative icon ID */
117 WORD offsDispName; /*06*/
118 WORD offsComment; /*08*/
119 CHAR szName[1]; /*10*/ /* terminated by 0x00, followed by display name and comment string */
120 } PIDLCPanelStruct;
122 typedef struct tagGUIDStruct
124 BYTE dummy; /* offset 01 is unknown */
125 GUID guid; /* offset 02 */
126 } GUIDStruct;
128 typedef struct tagDriveStruct
130 CHAR szDriveName[20]; /*01*/
131 WORD unknown; /*21*/
132 } DriveStruct;
134 typedef struct tagFileStruct
136 BYTE dummy; /*01 is 0x00 for files or dirs */
137 DWORD dwFileSize; /*02*/
138 WORD uFileDate; /*06*/
139 WORD uFileTime; /*08*/
140 WORD uFileAttribs; /*10*/
141 CHAR szNames[1]; /*12*/
142 /* Here are coming two strings. The first is the long name.
143 The second the dos name when needed or just 0x00 */
144 } FileStruct;
146 /* At least on WinXP, this struct is appended with 2-byte-alignment to FileStruct. There follows
147 * a WORD member after the wszName string, which gives the offset from the beginning of the PIDL
148 * to the FileStructW member. */
149 typedef struct tagFileStructW {
150 WORD cbLen;
151 BYTE dummy1[6];
152 WORD uCreationDate;
153 WORD uCreationTime;
154 WORD uLastAccessDate;
155 WORD uLastAccessTime;
156 BYTE dummy2[4];
157 WCHAR wszName[1];
158 } FileStructW;
160 typedef struct tagValueW
162 WCHAR name[1];
163 } ValueWStruct;
165 typedef struct tagPIDLDATA
166 { PIDLTYPE type; /*00*/
167 union
169 struct tagGUIDStruct guid;
170 struct tagDriveStruct drive;
171 struct tagFileStruct file;
172 struct
173 { WORD dummy; /*01*/
174 CHAR szNames[1]; /*03*/
175 } network;
176 struct
177 { WORD dummy; /*01*/
178 DWORD dummy1; /*02*/
179 CHAR szName[1]; /*06*/ /* terminated by 0x00 0x00 */
180 } htmlhelp;
181 struct tagPIDLCPanelStruct cpanel;
182 struct tagValueW valueW;
184 } PIDLDATA, *LPPIDLDATA;
185 #include "poppack.h"
188 * getting special values from simple pidls
190 DWORD _ILSimpleGetText (LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize);
191 DWORD _ILSimpleGetTextW (LPCITEMIDLIST pidl, LPWSTR pOut, UINT uOutSize);
192 BOOL _ILGetFileDate (LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize);
193 DWORD _ILGetFileSize (LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize);
194 BOOL _ILGetExtension (LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize);
195 void _ILGetFileType (LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize);
196 DWORD _ILGetFileAttributes (LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize);
198 BOOL _ILGetFileDateTime (LPCITEMIDLIST pidl, FILETIME *ft);
199 DWORD _ILGetDrive (LPCITEMIDLIST, LPSTR, UINT);
202 * testing simple pidls
204 BOOL _ILIsDesktop (LPCITEMIDLIST pidl);
205 BOOL _ILIsMyComputer (LPCITEMIDLIST pidl);
206 BOOL _ILIsDrive (LPCITEMIDLIST pidl);
207 BOOL _ILIsFolder (LPCITEMIDLIST pidl);
208 BOOL _ILIsValue (LPCITEMIDLIST pidl);
209 BOOL _ILIsSpecialFolder (LPCITEMIDLIST pidl);
210 BOOL _ILIsPidlSimple (LPCITEMIDLIST pidl);
211 BOOL _ILIsCPanelStruct (LPCITEMIDLIST pidl);
214 * simple pidls
217 /* Basic PIDL constructor. Allocates size + 5 bytes, where:
218 * - two bytes are SHITEMID.cb
219 * - one byte is PIDLDATA.type
220 * - two bytes are the NULL PIDL terminator
221 * Sets type of the returned PIDL to type.
223 LPITEMIDLIST _ILAlloc(PIDLTYPE type, unsigned int size);
225 /* Creates a PIDL with guid format and type type, which must be one of PT_GUID,
226 * PT_SHELLEXT, or PT_YAGUID.
228 LPITEMIDLIST _ILCreateGuid(PIDLTYPE type, REFIID guid);
230 /* Like _ILCreateGuid, but using the string szGUID. */
231 LPITEMIDLIST _ILCreateGuidFromStrA(LPCSTR szGUID);
232 LPITEMIDLIST _ILCreateGuidFromStrW(LPCWSTR szGUID);
234 /* Commonly used PIDLs representing file system objects. */
235 LPITEMIDLIST _ILCreateDesktop (void);
236 LPITEMIDLIST _ILCreateFromFindDataA(WIN32_FIND_DATAA *stffile);
237 LPITEMIDLIST _ILCreateFromFindDataW(WIN32_FIND_DATAW *stffile);
238 HRESULT _ILCreateFromPathA (LPCSTR szPath, LPITEMIDLIST* ppidl);
239 HRESULT _ILCreateFromPathW (LPCWSTR szPath, LPITEMIDLIST* ppidl);
241 /* Other helpers */
242 LPITEMIDLIST _ILCreateMyComputer (void);
243 LPITEMIDLIST _ILCreateIExplore (void);
244 LPITEMIDLIST _ILCreateControlPanel (void);
245 LPITEMIDLIST _ILCreatePrinters (void);
246 LPITEMIDLIST _ILCreateNetwork (void);
247 LPITEMIDLIST _ILCreateBitBucket (void);
248 LPITEMIDLIST _ILCreateDrive (LPCWSTR);
251 * helper functions (getting struct-pointer)
253 LPPIDLDATA _ILGetDataPointer (LPCITEMIDLIST);
254 LPSTR _ILGetTextPointer (LPCITEMIDLIST);
255 LPSTR _ILGetSTextPointer (LPCITEMIDLIST);
256 IID *_ILGetGUIDPointer (LPCITEMIDLIST pidl);
257 FileStructW *_ILGetFileStructW (LPCITEMIDLIST pidl);
260 * debug helper
262 void pdump (LPCITEMIDLIST pidl);
263 BOOL pcheck (LPCITEMIDLIST pidl);
266 * aPidl helper
268 void _ILFreeaPidl(LPITEMIDLIST * apidl, UINT cidl);
269 LPITEMIDLIST * _ILCopyaPidl(LPCITEMIDLIST * apidlsrc, UINT cidl);
270 LPITEMIDLIST * _ILCopyCidaToaPidl(LPITEMIDLIST* pidl, LPIDA cida);
272 BOOL WINAPI ILGetDisplayNameExA(LPSHELLFOLDER psf, LPCITEMIDLIST pidl, LPSTR path, DWORD type);
273 BOOL WINAPI ILGetDisplayNameExW(LPSHELLFOLDER psf, LPCITEMIDLIST pidl, LPWSTR path, DWORD type);
275 #endif