| /* |
| * internal pidl functions |
| * |
| * Copyright 1998 Juergen Schmied |
| * |
| * 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 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 desribes the type of pidl. |
| * |
| * object ! first byte / ! format ! living space |
| * ! size |
| * ---------------------------------------------------------------- |
| * my computer 0x1F/20 mycomp (2) (usual) |
| * network 0x1F mycomp |
| * bitbucket 0x1F mycomp |
| * drive 0x23/25 drive (usual) |
| * drive 0x25/25 drive (lnk/persistent) |
| * drive 0x29/25 drive |
| * shell extension 0x2E mycomp |
| * 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) |
| * 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) one string "\\sirius" |
| * (5) one string "whole network" |
| * (6) one string "\\sirius\c" |
| * (7) contains string "mk:@MSITStore:C:\path\file.chm::/path/filename.htm" |
| * GUID 871C5380-42A0-1069-A2EA-08002B30309D |
| */ |
| |
| #define PT_DESKTOP 0x00 /* internal */ |
| #define PT_MYCOMP 0x1F |
| #define PT_DRIVE 0x23 |
| #define PT_DRIVE2 0x25 |
| #define PT_DRIVE3 0x29 |
| #define PT_SPECIAL 0x2E |
| #define PT_DRIVE1 0x2F |
| #define PT_FOLDER1 0x30 |
| #define PT_FOLDER 0x31 |
| #define PT_VALUE 0x32 |
| #define PT_WORKGRP 0x41 |
| #define PT_COMP 0x42 |
| #define PT_NETPROVIDER 0x46 |
| #define PT_NETWORK 0x47 |
| #define PT_IESPECIAL1 0x61 |
| #define PT_RAS_FOLDER 0x70 |
| #define PT_IESPECIAL2 0xb1 |
| #define PT_SHARE 0xc3 |
| |
| #include "pshpack1.h" |
| typedef BYTE PIDLTYPE; |
| |
| typedef struct tagPIDLDATA |
| { PIDLTYPE type; /*00*/ |
| union |
| { struct |
| { BYTE dummy; /*01*/ |
| GUID guid; /*02*/ |
| BYTE dummy1; /*18*/ |
| } mycomp; |
| struct |
| { CHAR szDriveName[20]; /*01*/ |
| DWORD dwUnknown; /*21*/ |
| /* the drive seems to be 25 bytes every time */ |
| } drive; |
| struct |
| { 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 comming two strings. The first is the long name. |
| The second the dos name when needed or just 0x00 */ |
| } file, folder, generic; |
| struct |
| { WORD dummy; /*01*/ |
| CHAR szNames[1]; /*03*/ |
| } network; |
| struct |
| { WORD dummy; /*01*/ |
| DWORD dummy1; /*02*/ |
| CHAR szName[1]; /*06*/ /* teminated by 0x00 0x00 */ |
| } htmlhelp; |
| }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 _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); |
| |
| /* |
| * simple pidls from strings |
| */ |
| LPITEMIDLIST _ILCreate (PIDLTYPE,LPCVOID,UINT); |
| |
| LPITEMIDLIST _ILCreateDesktop (void); |
| LPITEMIDLIST _ILCreateMyComputer (void); |
| LPITEMIDLIST _ILCreateIExplore (void); |
| LPITEMIDLIST _ILCreateControl (void); |
| LPITEMIDLIST _ILCreatePrinter (void); |
| LPITEMIDLIST _ILCreateNetwork (void); |
| LPITEMIDLIST _ILCreateBitBucket (void); |
| LPITEMIDLIST _ILCreateDrive (LPCSTR); |
| LPITEMIDLIST _ILCreateFolder (WIN32_FIND_DATAA * stffile); |
| LPITEMIDLIST _ILCreateValue (WIN32_FIND_DATAA * stffile); |
| LPITEMIDLIST _ILCreateSpecial (LPCSTR szGUID); |
| LPITEMIDLIST _ILCreateFromPathA (LPCSTR szPath); |
| |
| /* |
| * helper functions (getting struct-pointer) |
| */ |
| LPPIDLDATA _ILGetDataPointer (LPCITEMIDLIST); |
| LPSTR _ILGetTextPointer (LPCITEMIDLIST); |
| LPSTR _ILGetSTextPointer (LPCITEMIDLIST); |
| REFIID _ILGetGUIDPointer (LPCITEMIDLIST pidl); |
| |
| /* |
| * debug helper |
| */ |
| void pdump (LPCITEMIDLIST pidl); |
| BOOL pcheck (LPCITEMIDLIST pidl); |
| |
| /* |
| * aPidl helper |
| */ |
| void _ILFreeaPidl(LPITEMIDLIST * apidl, UINT cidl); |
| LPITEMIDLIST * _ILCopyaPidl(LPCITEMIDLIST * apidlsrc, UINT cidl); |
| LPITEMIDLIST * _ILCopyCidaToaPidl(LPITEMIDLIST* pidl, LPIDA cida); |
| |
| BOOL WINAPI ILGetDisplayNameExA(LPSHELLFOLDER psf, LPCITEMIDLIST pidl, LPSTR path, DWORD type); |
| BOOL WINAPI ILGetDisplayNameExW(LPSHELLFOLDER psf, LPCITEMIDLIST pidl, LPWSTR path, DWORD type); |
| |
| HRESULT SHELL_GetPathFromIDListA(LPCITEMIDLIST pidl, LPSTR pszPath, UINT uOutSize); |
| HRESULT SHELL_GetPathFromIDListW(LPCITEMIDLIST pidl, LPWSTR pszPath, UINT uOutSize); |
| |
| #endif |
