[wintrust] Add some documentation (resend)

[Paul Vriens]

Hi,

hopefully it's a bit clearer now.

Changelog
  Add some documentation

Cheers,

Paul.
---
 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 )
 {
-- 
1.4.1.1