[PSDK]

* Annotate shellapi.h.

svn path=/trunk/; revision=59748

reactos/include/psdk/shellapi.h

@@ -369,46 +369,223 @@ typedef struct _SHNAMEMAPPINGW {
 #define SHGNLI_NOUNIQUE    0x04
 #define SHGNLI_NOLNK       0x08
 
-BOOL WINAPI SHGetNewLinkInfoA(LPCSTR,LPCSTR,LPSTR,BOOL*,UINT);
+LPWSTR * WINAPI CommandLineToArgvW(_In_ LPCWSTR, _Out_ int*);
-BOOL WINAPI SHGetNewLinkInfoW(LPCWSTR,LPCWSTR,LPWSTR,BOOL*,UINT);
+void WINAPI DragAcceptFiles(_In_ HWND, _In_ BOOL);
+void WINAPI DragFinish(_In_ HDROP);
 
-LPWSTR * WINAPI CommandLineToArgvW(LPCWSTR,int*);
+_Success_(return != 0)
-void WINAPI DragAcceptFiles(HWND,BOOL);
+UINT
-void WINAPI DragFinish(HDROP);
+WINAPI
-UINT WINAPI DragQueryFileA(HDROP,UINT,LPSTR,UINT);
+DragQueryFileA(
-UINT WINAPI DragQueryFileW(HDROP,UINT,LPWSTR,UINT);
+  _In_ HDROP hDrop,
-BOOL WINAPI DragQueryPoint(HDROP,LPPOINT);
+  _In_ UINT iFile,
-HICON WINAPI ExtractAssociatedIconA(HINSTANCE,LPSTR,PWORD);
+  _Out_writes_opt_(cch) LPSTR lpszFile,
-HICON WINAPI ExtractAssociatedIconW(HINSTANCE,LPWSTR,PWORD);
+  _In_ UINT cch);
-HICON WINAPI ExtractIconA(HINSTANCE,LPCSTR,UINT);
+
-HICON WINAPI ExtractIconW(HINSTANCE,LPCWSTR,UINT);
+_Success_(return != 0)
-UINT WINAPI ExtractIconExA(LPCSTR,int,HICON*,HICON*,UINT);
+UINT
-UINT WINAPI ExtractIconExW(LPCWSTR,int,HICON*,HICON*,UINT);
+WINAPI
-HINSTANCE WINAPI FindExecutableA(LPCSTR,LPCSTR,LPSTR);
+DragQueryFileW(
-HINSTANCE WINAPI FindExecutableW(LPCWSTR,LPCWSTR,LPWSTR);
+  _In_ HDROP hDrop,
-UINT_PTR WINAPI SHAppBarMessage(DWORD,PAPPBARDATA);
+  _In_ UINT iFile,
-BOOL WINAPI Shell_NotifyIconA(DWORD,PNOTIFYICONDATAA);
+  _Out_writes_opt_(cch) LPWSTR lpszFile,
-BOOL WINAPI Shell_NotifyIconW(DWORD,PNOTIFYICONDATAW);
+  _In_ UINT cch);
-int WINAPI ShellAboutA(HWND,LPCSTR,LPCSTR,HICON);
+
-int WINAPI ShellAboutW(HWND,LPCWSTR,LPCWSTR,HICON);
+BOOL WINAPI DragQueryPoint(_In_ HDROP, _Out_ LPPOINT);
-int WINAPI ShellMessageBoxA(HINSTANCE,HWND,LPCSTR,LPCSTR,UINT,...);
+
-int WINAPI ShellMessageBoxW(HINSTANCE,HWND,LPCWSTR,LPCWSTR,UINT,...);
+HICON
-HINSTANCE WINAPI ShellExecuteA(HWND,LPCSTR,LPCSTR,LPCSTR,LPCSTR,INT);
+WINAPI
-HINSTANCE WINAPI ShellExecuteW(HWND,LPCWSTR,LPCWSTR,LPCWSTR,LPCWSTR,INT);
+ExtractAssociatedIconA(
-BOOL WINAPI ShellExecuteExA(LPSHELLEXECUTEINFOA);
+  _Reserved_ HINSTANCE hInst,
-BOOL WINAPI ShellExecuteExW(LPSHELLEXECUTEINFOW);
+  _Inout_updates_(128) LPSTR pszIconPath,
-int WINAPI SHFileOperationA(LPSHFILEOPSTRUCTA);
+  _Inout_ WORD *piIcon);
-int WINAPI SHFileOperationW(LPSHFILEOPSTRUCTW);
+
-void WINAPI SHFreeNameMappings(HANDLE);
+HICON
-DWORD_PTR WINAPI SHGetFileInfoA(LPCSTR,DWORD,SHFILEINFOA*,UINT,UINT);
+WINAPI
-DWORD_PTR WINAPI SHGetFileInfoW(LPCWSTR,DWORD,SHFILEINFOW*,UINT,UINT);
+ExtractAssociatedIconW(
-BOOL WINAPI SHGetNewLinkInfoA(LPCSTR,LPCSTR,LPSTR,BOOL*,UINT);
+  _Reserved_ HINSTANCE hInst,
-BOOL WINAPI SHGetNewLinkInfoW(LPCWSTR,LPCWSTR,LPWSTR,BOOL*,UINT);
+  _Inout_updates_(128) LPWSTR pszIconPath,
-HRESULT WINAPI SHQueryRecycleBinA(LPCSTR, LPSHQUERYRBINFO);
+  _Inout_ WORD *piIcon);
-HRESULT WINAPI SHQueryRecycleBinW(LPCWSTR, LPSHQUERYRBINFO);
+
-HRESULT WINAPI SHEmptyRecycleBinA(HWND,LPCSTR,DWORD);
+HICON
-HRESULT WINAPI SHEmptyRecycleBinW(HWND,LPCWSTR,DWORD);
+WINAPI
-BOOL WINAPI SHCreateProcessAsUserW(PSHCREATEPROCESSINFOW);
+ExtractIconA(
+  _Reserved_ HINSTANCE hInst,
+  _In_ LPCSTR pszExeFileName,
+  UINT nIconIndex);
+
+HICON
+WINAPI
+ExtractIconW(
+  _Reserved_ HINSTANCE hInst,
+  _In_ LPCWSTR pszExeFileName,
+  UINT nIconIndex);
+
+UINT
+WINAPI
+ExtractIconExA(
+  _In_ LPCSTR lpszFile,
+  _In_ int nIconIndex,
+  _Out_writes_opt_(nIcons) HICON *phiconLarge,
+  _Out_writes_opt_(nIcons) HICON *phiconSmall,
+  _In_ UINT nIcons);
+
+UINT
+WINAPI
+ExtractIconExW(
+  _In_ LPCWSTR lpszFile,
+  _In_ int nIconIndex,
+  _Out_writes_opt_(nIcons) HICON *phiconLarge,
+  _Out_writes_opt_(nIcons) HICON *phiconSmall,
+  _In_ UINT nIcons);
+
+_Success_(return > 32)
+HINSTANCE
+WINAPI
+FindExecutableA(
+  _In_ LPCSTR lpFile,
+  _In_opt_ LPCSTR lpDirectory,
+  _Out_writes_(MAX_PATH) LPSTR lpResult);
+
+_Success_(return > 32)
+HINSTANCE
+WINAPI
+FindExecutableW(
+  _In_ LPCWSTR lpFile,
+  _In_opt_ LPCWSTR lpDirectory,
+  _Out_writes_(MAX_PATH) LPWSTR lpResult);
+
+UINT_PTR WINAPI SHAppBarMessage(_In_ DWORD, _Inout_ PAPPBARDATA);
+BOOL WINAPI Shell_NotifyIconA(_In_ DWORD, _In_ PNOTIFYICONDATAA);
+BOOL WINAPI Shell_NotifyIconW(_In_ DWORD, _In_ PNOTIFYICONDATAW);
+
+int
+WINAPI
+ShellAboutA(
+  _In_opt_ HWND hWnd,
+  _In_ LPCSTR szApp,
+  _In_opt_ LPCSTR szOtherStuff,
+  _In_opt_ HICON hIcon);
+
+int
+WINAPI
+ShellAboutW(
+  _In_opt_ HWND hWnd,
+  _In_ LPCWSTR szApp,
+  _In_opt_ LPCWSTR szOtherStuff,
+  _In_opt_ HICON hIcon);
+
+int
+WINAPI
+ShellMessageBoxA(
+  _In_opt_ HINSTANCE hAppInst,
+  _In_opt_ HWND hWnd,
+  _In_ LPCSTR lpcText,
+  _In_opt_ LPCSTR lpcTitle,
+  _In_ UINT fuStyle,
+  ...);
+
+int
+WINAPI
+ShellMessageBoxW(
+  _In_opt_ HINSTANCE hAppInst,
+  _In_opt_ HWND hWnd,
+  _In_ LPCWSTR lpcText,
+  _In_opt_ LPCWSTR lpcTitle,
+  _In_ UINT fuStyle,
+  ...);
+
+HINSTANCE
+WINAPI
+ShellExecuteA(
+  _In_opt_ HWND hwnd,
+  _In_opt_ LPCSTR lpOperation,
+  _In_ LPCSTR lpFile,
+  _In_opt_ LPCSTR lpParameters,
+  _In_opt_ LPCSTR lpDirectory,
+  _In_ INT nShowCmd);
+
+HINSTANCE
+WINAPI
+ShellExecuteW(
+  _In_opt_ HWND hwnd,
+  _In_opt_ LPCWSTR lpOperation,
+  _In_ LPCWSTR lpFile,
+  _In_opt_ LPCWSTR lpParameters,
+  _In_opt_ LPCWSTR lpDirectory,
+  _In_ INT nShowCmd);
+
+BOOL WINAPI ShellExecuteExA(_Inout_ LPSHELLEXECUTEINFOA);
+BOOL WINAPI ShellExecuteExW(_Inout_ LPSHELLEXECUTEINFOW);
+int WINAPI SHFileOperationA(_Inout_ LPSHFILEOPSTRUCTA);
+int WINAPI SHFileOperationW(_Inout_ LPSHFILEOPSTRUCTW);
+void WINAPI SHFreeNameMappings(_In_opt_ HANDLE);
+
+DWORD_PTR
+WINAPI
+SHGetFileInfoA(
+  _In_ LPCSTR pszPath,
+  DWORD dwFileAttributes,
+  _Inout_updates_bytes_opt_(cbFileInfo) SHFILEINFOA *psfi,
+  UINT cbFileInfo,
+  UINT uFlags);
+
+DWORD_PTR
+WINAPI
+SHGetFileInfoW(
+  _In_ LPCWSTR pszPath,
+  DWORD dwFileAttributes,
+  _Inout_updates_bytes_opt_(cbFileInfo) SHFILEINFOW *psfi,
+  UINT cbFileInfo,
+  UINT uFlags);
+
+_Success_(return != 0)
+BOOL
+WINAPI
+SHGetNewLinkInfoA(
+  _In_ LPCSTR pszLinkTo,
+  _In_ LPCSTR pszDir,
+  _Out_writes_(MAX_PATH) LPSTR pszName,
+  _Out_ BOOL *pfMustCopy,
+  _In_ UINT uFlags);
+
+_Success_(return != 0)
+BOOL
+WINAPI
+SHGetNewLinkInfoW(
+  _In_ LPCWSTR pszLinkTo,
+  _In_ LPCWSTR pszDir,
+  _Out_writes_(MAX_PATH) LPWSTR pszName,
+  _Out_ BOOL *pfMustCopy,
+  _In_ UINT uFlags);
+
+HRESULT
+WINAPI
+SHQueryRecycleBinA(
+  _In_opt_ LPCSTR pszRootPath,
+  _Inout_ LPSHQUERYRBINFO pSHQueryRBInfo);
+
+HRESULT
+WINAPI
+SHQueryRecycleBinW(
+  _In_opt_ LPCWSTR pszRootPath,
+  _Inout_ LPSHQUERYRBINFO pSHQueryRBInfo);
+
+HRESULT
+WINAPI
+SHEmptyRecycleBinA(
+  _In_opt_ HWND hwnd,
+  _In_opt_ LPCSTR pszRootPath,
+  DWORD dwFlags);
+
+HRESULT
+WINAPI
+SHEmptyRecycleBinW(
+  _In_opt_ HWND hwnd,
+  _In_opt_ LPCWSTR pszRootPath,
+  DWORD dwFlags);
+
+BOOL WINAPI SHCreateProcessAsUserW(_Inout_ PSHCREATEPROCESSINFOW);
 
 DWORD
 WINAPI
@@ -444,7 +621,6 @@ typedef LPSHNAMEMAPPINGW LPSHNAMEMAPPING;
 #define ShellMessageBox ShellMessageBoxW
 #define SHFileOperation SHFileOperationW
 #define SHGetFileInfo SHGetFileInfoW
-#define SHGetNewLinkInfo SHGetNewLinkInfoW
 #define SHQueryRecycleBin SHQueryRecycleBinW
 #define SHEmptyRecycleBin SHEmptyRecycleBinW
 #define SHGetNewLinkInfo SHGetNewLinkInfoW
@@ -472,7 +648,6 @@ typedef LPSHNAMEMAPPINGA LPSHNAMEMAPPING;
 #define ShellMessageBox ShellMessageBoxA
 #define SHFileOperation SHFileOperationA
 #define SHGetFileInfo SHGetFileInfoA
-#define SHGetNewLinkInfo SHGetNewLinkInfoA
 #define SHQueryRecycleBin SHQueryRecycleBinA
 #define SHEmptyRecycleBin SHEmptyRecycleBinA
 #define SHGetNewLinkInfo SHGetNewLinkInfoA