2 * internal pidl functions
3 * 1998 <juergen.schmied@metronet.de>
5 * DO NOT use this definitions outside the shell32.dll !
7 * The contents of a pidl should never used from a application
10 * This stuff is used from SHGetFileAttributes, ShellFolder
11 * EnumIDList and ShellView.
20 * the pidl does cache fileattributes to speed up SHGetAttributes when
21 * displaying a big number of files.
23 * a pidl of NULL means the desktop
25 * The structure of the pidl seems to be a union. The first byte of the
26 * PIDLDATA desribes the type of pidl.
28 * object ! first byte / ! format ! living space
30 * ----------------------------------------------------------------
31 * my computer 0x1F/20 mycomp (2) (usual)
32 * drive 0x23/25 drive (usual)
33 * drive 0x25/25 drive (lnk/persistant)
35 * shell extension 0x2E mycomp
36 * drive 0x2F drive (lnk/persistant)
37 * folder/file 0x30 folder/file (1) (lnk/persistant)
38 * folder 0x31 folder (usual)
39 * value 0x32 file (usual)
40 * workgroup 0x41 network (3)
41 * computer 0x42 network (4)
42 * whole network 0x47 network (5)
43 * MSITStore 0x61 htmlhlp (7)
44 * history/favorites 0xb1 file
45 * share 0xc3 network (6)
47 * guess: the persistant elements are non tracking
49 * (1) dummy byte is used, attributes are empty
50 * (2) IID_MyComputer = 20D04FE0L-3AEA-1069-A2D8-08002B30309D
51 * (3) two strings "workgroup" "microsoft network"
52 * (4) one string "\\sirius"
53 * (5) one string "whole network"
54 * (6) one string "\\sirius\c"
55 * (7) contains string "mk:@MSITStore:C:\path\file.chm::/path/filename.htm"
56 * GUID 871C5380-42A0-1069-A2EA-08002B30309D
59 #define PT_DESKTOP 0x00 /* internal */
60 #define PT_MYCOMP 0x1F
62 #define PT_DRIVE2 0x25
63 #define PT_DRIVE3 0x29
64 #define PT_SPECIAL 0x2E
65 #define PT_DRIVE1 0x2F
66 #define PT_FOLDER1 0x30
67 #define PT_FOLDER 0x31
69 #define PT_WORKGRP 0x41
71 #define PT_NETWORK 0x47
72 #define PT_IESPECIAL 0xb1
76 typedef BYTE PIDLTYPE;
78 typedef struct tagPIDLDATA
79 { PIDLTYPE type; /*00*/
87 { CHAR szDriveName[20]; /*01*/
88 DWORD dwUnknown; /*21*/
89 /* the drive seems to be 25 bytes every time */
92 { BYTE dummy; /*01 is 0x00 for files or dirs */
93 DWORD dwFileSize; /*02*/
94 WORD uFileDate; /*06*/
95 WORD uFileTime; /*08*/
96 WORD uFileAttribs; /*10*/
97 CHAR szNames[1]; /*12*/
98 /* Here are comming two strings. The first is the long name.
99 The second the dos name when needed or just 0x00 */
100 } file, folder, generic;
103 CHAR szNames[1]; /*03*/
108 CHAR szName[1]; /*06*/ /* teminated by 0x00 0x00 */
111 } PIDLDATA, *LPPIDLDATA;
115 * getting string values from pidls
117 * return value is strlen()
119 DWORD WINAPI _ILGetDrive(LPCITEMIDLIST,LPSTR,UINT16);
121 DWORD WINAPI _ILGetItemText(LPCITEMIDLIST,LPSTR,UINT16);
122 DWORD WINAPI _ILGetFolderText(LPCITEMIDLIST,LPSTR,DWORD);
123 DWORD WINAPI _ILGetValueText(LPCITEMIDLIST,LPSTR,DWORD);
124 DWORD WINAPI _ILGetPidlPath(LPCITEMIDLIST,LPSTR,DWORD);
128 * getting special values from simple pidls
130 BOOL WINAPI _ILGetFileDate (LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize);
131 BOOL WINAPI _ILGetFileSize (LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize);
132 BOOL WINAPI _ILGetExtension (LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize);
136 * testing simple pidls
138 BOOL WINAPI _ILIsDesktop(LPCITEMIDLIST);
139 BOOL WINAPI _ILIsMyComputer(LPCITEMIDLIST);
140 BOOL WINAPI _ILIsDrive(LPCITEMIDLIST);
141 BOOL WINAPI _ILIsFolder(LPCITEMIDLIST);
142 BOOL WINAPI _ILIsValue(LPCITEMIDLIST);
143 BOOL WINAPI _ILIsSpecialFolder (LPCITEMIDLIST pidl);
144 BOOL WINAPI _ILIsPidlSimple ( LPCITEMIDLIST pidl);
147 * simple pidls from strings
149 LPITEMIDLIST WINAPI _ILCreateDesktop(void);
150 LPITEMIDLIST WINAPI _ILCreateMyComputer(void);
151 LPITEMIDLIST WINAPI _ILCreateIExplore(void);
152 LPITEMIDLIST WINAPI _ILCreateDrive(LPCSTR);
153 LPITEMIDLIST WINAPI _ILCreateFolder(WIN32_FIND_DATAA * stffile);
154 LPITEMIDLIST WINAPI _ILCreateValue(WIN32_FIND_DATAA * stffile);
155 LPITEMIDLIST WINAPI _ILCreateSpecial(LPCSTR szGUID);
157 DWORD WINAPI _ILSimpleGetText (LPCITEMIDLIST pidl, LPSTR szOut, UINT uOutSize);
159 LPITEMIDLIST WINAPI _ILCreate(PIDLTYPE,LPCVOID,UINT16);
162 * helper functions (getting struct-pointer)
164 LPPIDLDATA WINAPI _ILGetDataPointer(LPCITEMIDLIST);
165 LPSTR WINAPI _ILGetTextPointer(PIDLTYPE type, LPPIDLDATA pidldata);
166 LPSTR WINAPI _ILGetSTextPointer(PIDLTYPE type, LPPIDLDATA pidldata);
167 REFIID WINAPI _ILGetGUIDPointer(LPCITEMIDLIST pidl);
169 void pdump (LPCITEMIDLIST pidl);
170 BOOL pcheck (LPCITEMIDLIST pidl);