[wintrust] Add some documentation
Paul Vriens
Paul.Vriens at xs4all.nl
Wed Aug 23 03:40:06 CDT 2006
Hi,
added some documentation. I've partly used stuff from James Hawkins' patch:
http://www.winehq.org/pipermail/wine-patches/2006-June/028123.html
I've removed the comment about Process Explorer and changed the location
of the Trust Providers.
Changelog
Add some documentation
Cheers,
Paul.
---
dlls/wintrust/wintrust_main.c | 45 +++++++++++++++++++++++++++++++++++------
1 files changed, 38 insertions(+), 7 deletions(-)
diff --git a/dlls/wintrust/wintrust_main.c b/dlls/wintrust/wintrust_main.c
index 4928116..d3b4dab 100644
--- a/dlls/wintrust/wintrust_main.c
+++ b/dlls/wintrust/wintrust_main.c
@@ -52,6 +52,18 @@ BOOL WINAPI DllMain( HINSTANCE inst, DWO
/***********************************************************************
* CryptCATAdminAcquireContext (WINTRUST.@)
+ *
+ * Get a catalog administrator context handle.
+ *
+ * PARAMS
+ * catAdmin [O] Pointer to the context handle.
+ * sysSystem [I] Pointer to a GUID for the needed subsystem.
+ * dwFlags [I] Reserved.
+ *
+ * RETURNS
+ * Success: TRUE. catAdmin contains the context handle.
+ * Failure: FAIL.
+ *
*/
BOOL WINAPI CryptCATAdminAcquireContext(HCATADMIN* catAdmin,
const GUID *sysSystem, DWORD dwFlags )
@@ -88,6 +100,17 @@ HCATINFO WINAPI CryptCATAdminEnumCatalog
/***********************************************************************
* CryptCATAdminReleaseContext (WINTRUST.@)
+ *
+ * Release a catalog administrator context handle.
+ *
+ * PARAMS
+ * catAdmin [I] Pointer to the context handle.
+ * dwFlags [I] Reserved.
+ *
+ * RETURNS
+ * Success: TRUE.
+ * Failure: FAIL.
+ *
*/
BOOL WINAPI CryptCATAdminReleaseContext(HCATADMIN hCatAdmin, DWORD dwFlags )
{
@@ -111,17 +134,25 @@ BOOL WINAPI TrustIsCertificateSelfSigned
/***********************************************************************
* WinVerifyTrust (WINTRUST.@)
+ *
+ * Verifies an object by calling the specified trust provider.
+ *
+ * PARAMS
+ * hwnd [I] Handle to a caller window.
+ * ActionID [I] Pointer to a GUID that identifies the action to perform.
+ * ActionData [I] Information used by the trust provider to verify the object.
+ *
+ * RETURNS
+ * Success: Zero.
+ * Failure: A TRUST_E_* error code.
+ *
+ * NOTES
+ * Trust providers can be found at:
+ * HKLM\SOFTWARE\Microsoft\Cryptography\Providers\Trust\
*/
LONG WINAPI WinVerifyTrust( HWND hwnd, GUID *ActionID, WINTRUST_DATA* ActionData )
{
FIXME("%p %s %p\n", hwnd, debugstr_guid(ActionID), ActionData);
-
- /* Trust providers can be found at:
- * HKLM\SOFTWARE\Microsoft\Cryptography\Providers\Trust\CertCheck\
- *
- * Process Explorer is now happy with ERROR_SUCCESS
- */
-
return ERROR_SUCCESS;
}
--
1.4.1.1
More information about the wine-patches
mailing list