Module: wine
Branch: master
Commit: 1f30d8994ade283d6f02a9781f4fbc4efaa18f32
URL: http://source.winehq.org/git/?p=wine.git;a=commit;h=1f30d8994ade283d6f02a97…
Author: Paul Vriens <Paul.Vriens(a)xs4all.nl>
Date: Tue Aug 29 19:33:00 2006 +0200
wintrust: Add some documentation.
---
dlls/wintrust/register.c | 34 ++++++++++++++++++++++++++++++++++
1 files changed, 34 insertions(+), 0 deletions(-)
diff --git a/dlls/wintrust/register.c b/dlls/wintrust/register.c
index 928d9e9..d01e343 100644
--- a/dlls/wintrust/register.c
+++ b/dlls/wintrust/register.c
@@ -34,6 +34,25 @@ WINE_DEFAULT_DEBUG_CHANNEL(wintrust);
/***********************************************************************
* WintrustAddActionID (WINTRUST.@)
+ *
+ * Add the definitions of the actions a Trust provider can perform to
+ * the registry.
+ *
+ * PARAMS
+ * pgActionID [I] Pointer to a GUID for the Trust provider.
+ * fdwFlags [I] Flag to indicate whether registry errors are passed on.
+ * psProvInfo [I] Pointer to a structure with information about DLL
+ * name and functions.
+ *
+ * RETURNS
+ * Success: TRUE.
+ * Failure: FALSE. (Use GetLastError() for more information)
+ *
+ * NOTES
+ * Adding a Trust provider is basically only adding relevant information
+ * to the registry. No verification takes place whether a DLL or it's
+ * entrypoints exist.
+ * Information in the registry will always be overwritten.
*/
BOOL WINAPI WintrustAddActionID( GUID* pgActionID, DWORD fdwFlags,
CRYPT_REGISTER_ACTIONID* psProvInfo)
@@ -45,6 +64,21 @@ BOOL WINAPI WintrustAddActionID( GUID* p
/***********************************************************************
* WintrustRemoveActionID (WINTRUST.@)
+ *
+ * Remove the definitions of the actions a Trust provider can perform
+ * from the registry.
+ *
+ * PARAMS
+ * pgActionID [I] Pointer to a GUID for the Trust provider.
+ *
+ * RETURNS
+ * Success: TRUE. (Use GetLastError() for more information)
+ * Failure: FALSE. (Use GetLastError() for more information)
+ *
+ * NOTES
+ * Testing shows that WintrustRemoveActionID always returns TRUE and
+ * that a possible error should be retrieved via GetLastError().
+ * There are no checks if the definitions are in the registry.
*/
BOOL WINAPI WintrustRemoveActionID( GUID* pgActionID )
{