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 * first byte - my Computer 0x1F
29 * control/printer 0x2E
32 * drive: the second byte is the start of a string
35 * file: see the PIDLDATA structure
38 #define PT_DESKTOP 0x00 /* internal */
39 #define PT_MYCOMP 0x1F
40 #define PT_SPECIAL 0x2E
42 #define PT_FOLDER 0x31
46 typedef BYTE PIDLTYPE;
48 typedef struct tagPIDLDATA
49 { PIDLTYPE type; /*00*/
52 { CHAR szDriveName[4]; /*01*/
53 /* end of MS compatible*/
55 /* the drive seems to be 19 bytes every time */
58 { BYTE dummy; /*01 is 0x00 for files or dirs */
59 DWORD dwFileSize; /*02*/
60 WORD uFileDate; /*06*/
61 WORD uFileTime; /*08*/
62 WORD uFileAttribs; /*10*/
63 /* end of MS compatible. Here are comming just one or two
64 strings. The first is the long name. The second the dos name
67 CHAR szAlternateName[14]; /* the 8.3 Name*/
68 CHAR szText[1]; /* last entry, variable size */
69 } file, folder, generic;
71 } PIDLDATA, *LPPIDLDATA;
75 * getting string values from pidls
77 * return value is strlen()
79 DWORD WINAPI _ILGetDrive(LPCITEMIDLIST,LPSTR,UINT16);
80 DWORD WINAPI _ILGetItemText(LPCITEMIDLIST,LPSTR,UINT16);
81 DWORD WINAPI _ILGetFolderText(LPCITEMIDLIST,LPSTR,DWORD);
82 DWORD WINAPI _ILGetValueText(LPCITEMIDLIST,LPSTR,DWORD);
83 DWORD WINAPI _ILGetPidlPath(LPCITEMIDLIST,LPSTR,DWORD);
86 * getting special values from simple pidls
88 BOOL32 WINAPI _ILGetFileDate (LPCITEMIDLIST pidl, LPSTR pOut, UINT32 uOutSize);
89 BOOL32 WINAPI _ILGetFileSize (LPCITEMIDLIST pidl, LPSTR pOut, UINT32 uOutSize);
90 BOOL32 WINAPI _ILGetExtension (LPCITEMIDLIST pidl, LPSTR pOut, UINT32 uOutSize);
94 * testing simple pidls
96 BOOL32 WINAPI _ILIsDesktop(LPCITEMIDLIST);
97 BOOL32 WINAPI _ILIsMyComputer(LPCITEMIDLIST);
98 BOOL32 WINAPI _ILIsDrive(LPCITEMIDLIST);
99 BOOL32 WINAPI _ILIsFolder(LPCITEMIDLIST);
100 BOOL32 WINAPI _ILIsValue(LPCITEMIDLIST);
103 * simple pidls from strings
105 LPITEMIDLIST WINAPI _ILCreateDesktop(void);
106 LPITEMIDLIST WINAPI _ILCreateMyComputer(void);
107 LPITEMIDLIST WINAPI _ILCreateDrive(LPCSTR);
108 LPITEMIDLIST WINAPI _ILCreateFolder(LPCSTR);
109 LPITEMIDLIST WINAPI _ILCreateValue(LPCSTR);
112 * raw pidl handling (binary)
114 * data is binary / sizes are bytes
116 DWORD WINAPI _ILGetData(PIDLTYPE,LPCITEMIDLIST,LPVOID,UINT32);
117 LPITEMIDLIST WINAPI _ILCreate(PIDLTYPE,LPVOID,UINT16);
120 * helper functions (getting struct-pointer)
122 LPPIDLDATA WINAPI _ILGetDataPointer(LPCITEMIDLIST);
123 LPSTR WINAPI _ILGetTextPointer(PIDLTYPE type, LPPIDLDATA pidldata);
125 void pdump (LPCITEMIDLIST pidl);