/* * internal pidl functions * * Copyright 1998 Juergen Schmied * Copyright 2004 Juan Lang * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA * * NOTES: * * DO NOT use this definitions outside the shell32.dll ! * * The contents of a pidl should never used from a application * directly. * * Undocumented: * MS says: the abID of SHITEMID should be treated as binary data and not * be interpreted by applications. Applies to everyone but MS itself. * Word95 interprets the contents of abID (Filesize/Date) so we have to go * for binary compatibility here. */ #ifndef __WINE_PIDL_H #define __WINE_PIDL_H #include <stdarg.h> #include "windef.h" #include "winbase.h" #include "winuser.h" #include "shlobj.h" /* * the pidl does cache fileattributes to speed up SHGetAttributes when * displaying a big number of files. * * a pidl of NULL means the desktop * * The structure of the pidl seems to be a union. The first byte of the * PIDLDATA describes the type of pidl. * * object ! first byte / ! format ! living space * ! size * ---------------------------------------------------------------- * my computer 0x1F/20 guid (2) (usual) * network 0x1F guid * bitbucket 0x1F guid * drive 0x23/25 drive (usual) * drive 0x25/25 drive (lnk/persistent) * drive 0x29/25 drive * shell extension 0x2E guid * drive 0x2F drive (lnk/persistent) * folder/file 0x30 folder/file (1) (lnk/persistent) * folder 0x31 folder (usual) * valueA 0x32 file (ANSI file name) * valueW 0x34 file (Unicode file name) * workgroup 0x41 network (3) * computer 0x42 network (4) * net provider 0x46 network * whole network 0x47 network (5) * MSITStore 0x61 htmlhlp (7) * printers/ras connections 0x70 guid * history/favorites 0xb1 file * share 0xc3 network (6) * * guess: the persistent elements are non tracking * * (1) dummy byte is used, attributes are empty * (2) IID_MyComputer = 20D04FE0L-3AEA-1069-A2D8-08002B30309D * (3) two strings "workgroup" "Microsoft Network" * (4) two strings "\\sirius" "Microsoft Network" * (5) one string "Entire Network" * (6) two strings "\\sirius\c" "Microsoft Network" * (7) contains string "mk:@MSITStore:C:\path\file.chm::/path/filename.htm" * GUID 871C5380-42A0-1069-A2EA-08002B30309D */ #define PT_CPLAPPLET 0x00 #define PT_GUID 0x1F #define PT_DRIVE 0x23 #define PT_DRIVE2 0x25 #define PT_DRIVE3 0x29 #define PT_SHELLEXT 0x2E #define PT_DRIVE1 0x2F #define PT_FOLDER1 0x30 #define PT_FOLDER 0x31 #define PT_VALUE 0x32 #define PT_VALUEW 0x34 #define PT_WORKGRP 0x41 #define PT_COMP 0x42 #define PT_NETPROVIDER 0x46 #define PT_NETWORK 0x47 #define PT_IESPECIAL1 0x61 #define PT_YAGUID 0x70 /* yet another guid.. */ #define PT_IESPECIAL2 0xb1 #define PT_SHARE 0xc3 #include "pshpack1.h" typedef BYTE PIDLTYPE; typedef struct tagPIDLCPanelStruct { BYTE dummy; /*01 is 0x00 */ DWORD iconIdx; /*02 negative icon ID */ WORD offsDispName; /*06*/ WORD offsComment; /*08*/ CHAR szName[1]; /*10*/ /* terminated by 0x00, followed by display name and comment string */ } PIDLCPanelStruct; typedef struct tagGUIDStruct { BYTE dummy; /* offset 01 is unknown */ GUID guid; /* offset 02 */ } GUIDStruct; typedef struct tagDriveStruct { CHAR szDriveName[20]; /*01*/ WORD unknown; /*21*/ } DriveStruct; typedef struct tagFileStruct { BYTE dummy; /*01 is 0x00 for files or dirs */ DWORD dwFileSize; /*02*/ WORD uFileDate; /*06*/ WORD uFileTime; /*08*/ WORD uFileAttribs; /*10*/ CHAR szNames[1]; /*12*/ /* Here are coming two strings. The first is the long name. The second the dos name when needed or just 0x00 */ } FileStruct; /* At least on WinXP, this struct is appended with 2-byte-alignment to FileStruct. There follows * a WORD member after the wszName string, which gives the offset from the beginning of the PIDL * to the FileStructW member. */ typedef struct tagFileStructW { WORD cbLen; BYTE dummy1[6]; WORD uCreationDate; WORD uCreationTime; WORD uLastAccessDate; WORD uLastAccessTime; BYTE dummy2[4]; WCHAR wszName[1]; } FileStructW; typedef struct tagValueW { WCHAR name[1]; } ValueWStruct; typedef struct tagPIDLDATA { PIDLTYPE type; /*00*/ union { struct tagGUIDStruct guid; struct tagDriveStruct drive; struct tagFileStruct file; struct { WORD dummy; /*01*/ CHAR szNames[1]; /*03*/ } network; struct { WORD dummy; /*01*/ DWORD dummy1; /*02*/ CHAR szName[1]; /*06*/ /* terminated by 0x00 0x00 */ } htmlhelp; struct tagPIDLCPanelStruct cpanel; struct tagValueW valueW; }u; } PIDLDATA, *LPPIDLDATA; #include "poppack.h" /* * getting special values from simple pidls */ DWORD _ILSimpleGetText (LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize); DWORD _ILSimpleGetTextW (LPCITEMIDLIST pidl, LPWSTR pOut, UINT uOutSize); BOOL _ILGetFileDate (LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize); DWORD _ILGetFileSize (LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize); BOOL _ILGetExtension (LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize); void _ILGetFileType (LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize); DWORD _ILGetFileAttributes (LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize); BOOL _ILGetFileDateTime (LPCITEMIDLIST pidl, FILETIME *ft); DWORD _ILGetDrive (LPCITEMIDLIST, LPSTR, UINT); /* * testing simple pidls */ BOOL _ILIsUnicode (LPCITEMIDLIST pidl); BOOL _ILIsDesktop (LPCITEMIDLIST pidl); BOOL _ILIsMyComputer (LPCITEMIDLIST pidl); BOOL _ILIsDrive (LPCITEMIDLIST pidl); BOOL _ILIsFolder (LPCITEMIDLIST pidl); BOOL _ILIsValue (LPCITEMIDLIST pidl); BOOL _ILIsSpecialFolder (LPCITEMIDLIST pidl); BOOL _ILIsPidlSimple (LPCITEMIDLIST pidl); BOOL _ILIsCPanelStruct (LPCITEMIDLIST pidl); static inline BOOL _ILIsEqualSimple (LPCITEMIDLIST pidlA, LPCITEMIDLIST pidlB) { return (pidlA->mkid.cb > 0 && !memcmp(pidlA, pidlB, pidlA->mkid.cb)) || (!pidlA->mkid.cb && !pidlB->mkid.cb); } static inline BOOL _ILIsEmpty (LPCITEMIDLIST pidl) { return _ILIsDesktop(pidl); } /* * simple pidls */ /* Creates a PIDL with guid format and type type, which must be one of PT_GUID, * PT_SHELLEXT, or PT_YAGUID. */ LPITEMIDLIST _ILCreateGuid(PIDLTYPE type, REFIID guid); /* Like _ILCreateGuid, but using the string szGUID. */ LPITEMIDLIST _ILCreateGuidFromStrA(LPCSTR szGUID); LPITEMIDLIST _ILCreateGuidFromStrW(LPCWSTR szGUID); /* Commonly used PIDLs representing file system objects. */ LPITEMIDLIST _ILCreateDesktop (void); LPITEMIDLIST _ILCreateFromFindDataW(const WIN32_FIND_DATAW *stffile); HRESULT _ILCreateFromPathW (LPCWSTR szPath, LPITEMIDLIST* ppidl); /* Other helpers */ LPITEMIDLIST _ILCreateMyComputer (void); LPITEMIDLIST _ILCreateMyDocuments (void); LPITEMIDLIST _ILCreateIExplore (void); LPITEMIDLIST _ILCreateControlPanel (void); LPITEMIDLIST _ILCreatePrinters (void); LPITEMIDLIST _ILCreateNetwork (void); LPITEMIDLIST _ILCreateNetHood (void); LPITEMIDLIST _ILCreateBitBucket (void); LPITEMIDLIST _ILCreateDrive (LPCWSTR); LPITEMIDLIST _ILCreateEntireNetwork (void); /* * helper functions (getting struct-pointer) */ LPPIDLDATA _ILGetDataPointer (LPCITEMIDLIST); LPSTR _ILGetTextPointer (LPCITEMIDLIST); IID *_ILGetGUIDPointer (LPCITEMIDLIST pidl); FileStructW *_ILGetFileStructW (LPCITEMIDLIST pidl); /* * debug helper */ void pdump (LPCITEMIDLIST pidl); BOOL pcheck (LPCITEMIDLIST pidl); /* * aPidl helper */ void _ILFreeaPidl(LPITEMIDLIST * apidl, UINT cidl); LPITEMIDLIST * _ILCopyaPidl(const LPCITEMIDLIST * apidlsrc, UINT cidl); LPITEMIDLIST * _ILCopyCidaToaPidl(LPITEMIDLIST* pidl, const CIDA * cida); BOOL WINAPI ILGetDisplayNameExW(LPSHELLFOLDER psf, LPCITEMIDLIST pidl, LPWSTR path, DWORD type); #endif