| 1 | /*
|
|---|
| 2 | * internal pidl functions
|
|---|
| 3 | * 1998 <juergen.schmied@metronet.de>
|
|---|
| 4 | *
|
|---|
| 5 | * DO NOT use this definitions outside the shell32.dll !
|
|---|
| 6 | *
|
|---|
| 7 | * The contents of a pidl should never used from a application
|
|---|
| 8 | * directly.
|
|---|
| 9 | *
|
|---|
| 10 | * Undocumented:
|
|---|
| 11 | * MS says: the abID of SHITEMID should be treated as binary data and not
|
|---|
| 12 | * be interpreted by applications. Applies to everyone but MS itself.
|
|---|
| 13 | * Word95 interprets the contents of abID (Filesize/Date) so we have to go
|
|---|
| 14 | * for binary compatibility here.
|
|---|
| 15 | */
|
|---|
| 16 |
|
|---|
| 17 | #ifndef __WINE_PIDL_H
|
|---|
| 18 | #define __WINE_PIDL_H
|
|---|
| 19 |
|
|---|
| 20 | #include "shlobj.h"
|
|---|
| 21 |
|
|---|
| 22 | /*
|
|---|
| 23 | * the pidl does cache fileattributes to speed up SHGetAttributes when
|
|---|
| 24 | * displaying a big number of files.
|
|---|
| 25 | *
|
|---|
| 26 | * a pidl of NULL means the desktop
|
|---|
| 27 | *
|
|---|
| 28 | * The structure of the pidl seems to be a union. The first byte of the
|
|---|
| 29 | * PIDLDATA desribes the type of pidl.
|
|---|
| 30 | *
|
|---|
| 31 | * object ! first byte / ! format ! living space
|
|---|
| 32 | * ! size
|
|---|
| 33 | * ----------------------------------------------------------------
|
|---|
| 34 | * my computer 0x1F/20 mycomp (2) (usual)
|
|---|
| 35 | * network 0x1F mycomp
|
|---|
| 36 | * bitbucket 0x1F mycomp
|
|---|
| 37 | * drive 0x23/25 drive (usual)
|
|---|
| 38 | * drive 0x25/25 drive (lnk/persistant)
|
|---|
| 39 | * drive 0x29/25 drive
|
|---|
| 40 | * shell extension 0x2E mycomp
|
|---|
| 41 | * drive 0x2F drive (lnk/persistant)
|
|---|
| 42 | * folder/file 0x30 folder/file (1) (lnk/persistant)
|
|---|
| 43 | * folder 0x31 folder (usual)
|
|---|
| 44 | * value 0x32 file (usual)
|
|---|
| 45 | * workgroup 0x41 network (3)
|
|---|
| 46 | * computer 0x42 network (4)
|
|---|
| 47 | * whole network 0x47 network (5)
|
|---|
| 48 | * MSITStore 0x61 htmlhlp (7)
|
|---|
| 49 | * history/favorites 0xb1 file
|
|---|
| 50 | * share 0xc3 network (6)
|
|---|
| 51 | *
|
|---|
| 52 | * guess: the persistant elements are non tracking
|
|---|
| 53 | *
|
|---|
| 54 | * (1) dummy byte is used, attributes are empty
|
|---|
| 55 | * (2) IID_MyComputer = 20D04FE0L-3AEA-1069-A2D8-08002B30309D
|
|---|
| 56 | * (3) two strings "workgroup" "microsoft network"
|
|---|
| 57 | * (4) one string "\\sirius"
|
|---|
| 58 | * (5) one string "whole network"
|
|---|
| 59 | * (6) one string "\\sirius\c"
|
|---|
| 60 | * (7) contains string "mk:@MSITStore:C:\path\file.chm::/path/filename.htm"
|
|---|
| 61 | * GUID 871C5380-42A0-1069-A2EA-08002B30309D
|
|---|
| 62 | */
|
|---|
| 63 |
|
|---|
| 64 | #define PT_DESKTOP 0x00 /* internal */
|
|---|
| 65 | #define PT_MYCOMP 0x1F
|
|---|
| 66 | #define PT_DRIVE 0x23
|
|---|
| 67 | #define PT_DRIVE2 0x25
|
|---|
| 68 | #define PT_DRIVE3 0x29
|
|---|
| 69 | #define PT_SPECIAL 0x2E
|
|---|
| 70 | #define PT_DRIVE1 0x2F
|
|---|
| 71 | #define PT_FOLDER1 0x30
|
|---|
| 72 | #define PT_FOLDER 0x31
|
|---|
| 73 | #define PT_VALUE 0x32
|
|---|
| 74 | #define PT_WORKGRP 0x41
|
|---|
| 75 | #define PT_COMP 0x42
|
|---|
| 76 | #define PT_NETWORK 0x47
|
|---|
| 77 | #define PT_IESPECIAL1 0x61
|
|---|
| 78 | #define PT_IESPECIAL2 0xb1
|
|---|
| 79 | #define PT_SHARE 0xc3
|
|---|
| 80 |
|
|---|
| 81 | #include "pshpack1.h"
|
|---|
| 82 | typedef BYTE PIDLTYPE;
|
|---|
| 83 |
|
|---|
| 84 | typedef struct tagPIDLDATA
|
|---|
| 85 | { PIDLTYPE type; /*00*/
|
|---|
| 86 | union
|
|---|
| 87 | { struct
|
|---|
| 88 | { BYTE dummy; /*01*/
|
|---|
| 89 | GUID guid; /*02*/
|
|---|
| 90 | BYTE dummy1; /*18*/
|
|---|
| 91 | } mycomp;
|
|---|
| 92 | struct
|
|---|
| 93 | { CHAR szDriveName[20]; /*01*/
|
|---|
| 94 | DWORD dwUnknown; /*21*/
|
|---|
| 95 | /* the drive seems to be 25 bytes every time */
|
|---|
| 96 | } drive;
|
|---|
| 97 | struct
|
|---|
| 98 | { BYTE dummy; /*01 is 0x00 for files or dirs */
|
|---|
| 99 | DWORD dwFileSize; /*02*/
|
|---|
| 100 | WORD uFileDate; /*06*/
|
|---|
| 101 | WORD uFileTime; /*08*/
|
|---|
| 102 | WORD uFileAttribs; /*10*/
|
|---|
| 103 | CHAR szNames[1]; /*12*/
|
|---|
| 104 | /* Here are comming two strings. The first is the long name.
|
|---|
| 105 | The second the dos name when needed or just 0x00 */
|
|---|
| 106 | } file, folder, generic;
|
|---|
| 107 | struct
|
|---|
| 108 | { WORD dummy; /*01*/
|
|---|
| 109 | CHAR szNames[1]; /*03*/
|
|---|
| 110 | } network;
|
|---|
| 111 | struct
|
|---|
| 112 | { WORD dummy; /*01*/
|
|---|
| 113 | DWORD dummy1; /*02*/
|
|---|
| 114 | CHAR szName[1]; /*06*/ /* teminated by 0x00 0x00 */
|
|---|
| 115 | } htmlhelp;
|
|---|
| 116 | }u;
|
|---|
| 117 | } PIDLDATA, *LPPIDLDATA;
|
|---|
| 118 | #include "poppack.h"
|
|---|
| 119 |
|
|---|
| 120 | /*
|
|---|
| 121 | * getting special values from simple pidls
|
|---|
| 122 | */
|
|---|
| 123 | DWORD _ILSimpleGetText (LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize);
|
|---|
| 124 | BOOL _ILGetFileDate (LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize);
|
|---|
| 125 | DWORD _ILGetFileSize (LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize);
|
|---|
| 126 | BOOL _ILGetExtension (LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize);
|
|---|
| 127 | void _ILGetFileType (LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize);
|
|---|
| 128 | DWORD _ILGetFileAttributes (LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize);
|
|---|
| 129 |
|
|---|
| 130 | BOOL _ILGetFileDateTime (LPCITEMIDLIST pidl, FILETIME *ft);
|
|---|
| 131 | DWORD _ILGetDrive (LPCITEMIDLIST, LPSTR, UINT);
|
|---|
| 132 |
|
|---|
| 133 | /*
|
|---|
| 134 | * testing simple pidls
|
|---|
| 135 | */
|
|---|
| 136 | BOOL _ILIsDesktop (LPCITEMIDLIST pidl);
|
|---|
| 137 | BOOL _ILIsMyComputer (LPCITEMIDLIST pidl);
|
|---|
| 138 | BOOL _ILIsDrive (LPCITEMIDLIST pidl);
|
|---|
| 139 | BOOL _ILIsFolder (LPCITEMIDLIST pidl);
|
|---|
| 140 | BOOL _ILIsValue (LPCITEMIDLIST pidl);
|
|---|
| 141 | BOOL _ILIsSpecialFolder (LPCITEMIDLIST pidl);
|
|---|
| 142 | BOOL _ILIsPidlSimple (LPCITEMIDLIST pidl);
|
|---|
| 143 |
|
|---|
| 144 | /*
|
|---|
| 145 | * simple pidls from strings
|
|---|
| 146 | */
|
|---|
| 147 | LPITEMIDLIST _ILCreate (PIDLTYPE,LPCVOID,UINT);
|
|---|
| 148 |
|
|---|
| 149 | LPITEMIDLIST _ILCreateDesktop (void);
|
|---|
| 150 | LPITEMIDLIST _ILCreateMyComputer (void);
|
|---|
| 151 | LPITEMIDLIST _ILCreateIExplore (void);
|
|---|
| 152 | LPITEMIDLIST _ILCreateControl (void);
|
|---|
| 153 | LPITEMIDLIST _ILCreatePrinter (void);
|
|---|
| 154 | LPITEMIDLIST _ILCreateNetwork (void);
|
|---|
| 155 | LPITEMIDLIST _ILCreateBitBucket (void);
|
|---|
| 156 | LPITEMIDLIST _ILCreateDrive (LPCSTR);
|
|---|
| 157 | LPITEMIDLIST _ILCreateFolder (WIN32_FIND_DATAA * stffile);
|
|---|
| 158 | LPITEMIDLIST _ILCreateValue (WIN32_FIND_DATAA * stffile);
|
|---|
| 159 | LPITEMIDLIST _ILCreateSpecial (LPCSTR szGUID);
|
|---|
| 160 |
|
|---|
| 161 | /*
|
|---|
| 162 | * helper functions (getting struct-pointer)
|
|---|
| 163 | */
|
|---|
| 164 | LPPIDLDATA _ILGetDataPointer (LPCITEMIDLIST);
|
|---|
| 165 | LPSTR _ILGetTextPointer (LPCITEMIDLIST);
|
|---|
| 166 | LPSTR _ILGetSTextPointer (LPCITEMIDLIST);
|
|---|
| 167 | REFIID _ILGetGUIDPointer (LPCITEMIDLIST pidl);
|
|---|
| 168 |
|
|---|
| 169 | /*
|
|---|
| 170 | * debug helper
|
|---|
| 171 | */
|
|---|
| 172 | #if defined(__WIN32OS2__) && defined(DEBUG)
|
|---|
| 173 | void pdump (LPCITEMIDLIST pidl);
|
|---|
| 174 | #else
|
|---|
| 175 | #define pdump(pidl)
|
|---|
| 176 | #endif
|
|---|
| 177 | BOOL pcheck (LPCITEMIDLIST pidl);
|
|---|
| 178 |
|
|---|
| 179 | /*
|
|---|
| 180 | * aPidl helper
|
|---|
| 181 | */
|
|---|
| 182 | void _ILFreeaPidl(LPITEMIDLIST * apidl, UINT cidl);
|
|---|
| 183 | LPITEMIDLIST * _ILCopyaPidl(LPITEMIDLIST * apidlsrc, UINT cidl);
|
|---|
| 184 | LPITEMIDLIST * _ILCopyCidaToaPidl(LPITEMIDLIST* pidl, LPCIDA cida);
|
|---|
| 185 |
|
|---|
| 186 | #endif
|
|---|
