Documentation standardizations.

dlls/advapi32/advapi.c

@@ -11,10 +11,11 @@
 
 #include <unistd.h>
 
-/***********************************************************************
- *           GetUserNameA   [ADVAPI32.67]
+/******************************************************************************
+ * GetUserName32A [ADVAPI32.67]
  */
-BOOL32 WINAPI GetUserName32A(LPSTR lpszName, LPDWORD lpSize)
+BOOL32 WINAPI
+GetUserName32A( LPSTR lpszName, LPDWORD lpSize )
 {
   size_t len;
   char *name;
@@ -34,10 +35,15 @@ BOOL32 WINAPI GetUserName32A(LPSTR lpszName, LPDWORD lpSize)
   return 1;
 }
 
-/***********************************************************************
- *           GetUserNameW   [ADVAPI32.68]
+/******************************************************************************
+ * GetUserName32W [ADVAPI32.68]
+ *
+ * PARAMS
+ *   lpszName []
+ *   lpSize   []
  */
-BOOL32 WINAPI GetUserName32W(LPWSTR lpszName, LPDWORD lpSize)
+BOOL32 WINAPI
+GetUserName32W( LPWSTR lpszName, LPDWORD lpSize )
 {
 	LPSTR name = (LPSTR)HeapAlloc( GetProcessHeap(), 0, *lpSize );
 	DWORD	size = *lpSize;

dlls/advapi32/eventlog.c

@@ -17,10 +17,16 @@ BOOL32 WINAPI BackupEventLog32A( HANDLE32 hEventLog, LPCSTR lpBackupFileName )
 	FIXME(advapi,"stub\n");
 	return TRUE;
 }
+
 /******************************************************************************
  * BackupEventLog32W [ADVAPI32.16]
+ *
+ * PARAMS
+ *   hEventLog        []
+ *   lpBackupFileName []
  */
-BOOL32 WINAPI BackupEventLog32W( HANDLE32 hEventLog, LPCWSTR lpBackupFileName )
+BOOL32 WINAPI
+BackupEventLog32W( HANDLE32 hEventLog, LPCWSTR lpBackupFileName )
 {
 	FIXME(advapi,"stub\n");
 	return TRUE;
@@ -70,24 +76,38 @@ BOOL32 WINAPI DeregisterEventSource32( HANDLE32 hEventLog )
 
 /******************************************************************************
  * GetNumberOfEventLogRecords32 [ADVAPI32.49]
+ *
+ * PARAMS
+ *   hEventLog       []
+ *   NumberOfRecords []
  */
-BOOL32 WINAPI GetNumberOfEventLogRecords32( HANDLE32 hEventLog, PDWORD NumberOfRecords )
+BOOL32 WINAPI
+GetNumberOfEventLogRecords32( HANDLE32 hEventLog, PDWORD NumberOfRecords )
 {
 	FIXME(advapi,"stub\n");
 	return TRUE;
 }
 
 /******************************************************************************
- * GetOldestEventLogRecord			[ADVAPI32.50]
+ * GetOldestEventLogRecord32 [ADVAPI32.50]
+ *
+ * PARAMS
+ *   hEventLog    []
+ *   OldestRecord []
  */
-BOOL32 WINAPI GetOldestEventLogRecord32( HANDLE32 hEventLog, PDWORD OldestRecord )
+BOOL32 WINAPI
+GetOldestEventLogRecord32( HANDLE32 hEventLog, PDWORD OldestRecord )
 {
-	FIXME(advapi,"stub\n");
+	FIXME(advapi,":stub\n");
 	return TRUE;
 }
 
 /******************************************************************************
  * NotifyChangeEventLog32 [ADVAPI32.98]
+ *
+ * PARAMS
+ *   hEventLog []
+ *   hEvent    []
  */
 BOOL32 WINAPI NotifyChangeEventLog32( HANDLE32 hEventLog, HANDLE32 hEvent )
 {
@@ -98,7 +118,8 @@ BOOL32 WINAPI NotifyChangeEventLog32( HANDLE32 hEventLog, HANDLE32 hEvent )
 /******************************************************************************
  * OpenBackupEventLog32A [ADVAPI32.105]
  */
-HANDLE32 WINAPI OpenBackupEventLog32A( LPCSTR lpUNCServerName, LPCSTR lpFileName )
+HANDLE32 WINAPI
+OpenBackupEventLog32A( LPCSTR lpUNCServerName, LPCSTR lpFileName )
 {
 	FIXME(advapi,"stub\n");
 	return TRUE;
@@ -106,15 +127,20 @@ HANDLE32 WINAPI OpenBackupEventLog32A( LPCSTR lpUNCServerName, LPCSTR lpFileName
 
 /******************************************************************************
  * OpenBackupEventLog32W [ADVAPI32.106]
+ *
+ * PARAMS
+ *   lpUNCServerName []
+ *   lpFileName      []
  */
-HANDLE32 WINAPI OpenBackupEventLog32W( LPCWSTR lpUNCServerName, LPCWSTR lpFileName )
+HANDLE32 WINAPI
+OpenBackupEventLog32W( LPCWSTR lpUNCServerName, LPCWSTR lpFileName )
 {
 	FIXME(advapi,"stub\n");
 	return TRUE;
 }
 
 /******************************************************************************
- * OpenEventLogA				[ADVAPI32.107]
+ * OpenEventLog32A [ADVAPI32.107]
  */
 HANDLE32 WINAPI OpenEventLog32A(LPCSTR uncname,LPCSTR source) 
 {
@@ -124,8 +150,13 @@ HANDLE32 WINAPI OpenEventLog32A(LPCSTR uncname,LPCSTR source)
 
 /******************************************************************************
  * OpenEventLog32W [ADVAPI32.108]
+ *
+ * PARAMS
+ *   uncname []
+ *   source  []
  */
-HANDLE32 WINAPI OpenEventLog32W(LPCWSTR uncname,LPCWSTR source)
+HANDLE32 WINAPI
+OpenEventLog32W( LPCWSTR uncname, LPCWSTR source )
 {
 	FIXME(advapi,"stub\n");
 	return TRUE;
@@ -143,9 +174,20 @@ BOOL32 WINAPI ReadEventLog32A( HANDLE32 hEventLog, DWORD dwReadFlags, DWORD dwRe
 
 /******************************************************************************
  * ReadEventLog32W [ADVAPI32.125]
+ *
+ * PARAMS
+ *   hEventLog                []
+ *   dwReadFlags              []
+ *   dwRecordOffset           []
+ *   lpBuffer                 []
+ *   nNumberOfBytesToRead     []
+ *   pnBytesRead              []
+ *   pnMinNumberOfBytesNeeded []
  */
-BOOL32 WINAPI ReadEventLog32W( HANDLE32 hEventLog, DWORD dwReadFlags, DWORD dwRecordOffset,
-    LPVOID lpBuffer, DWORD nNumberOfBytesToRead, DWORD *pnBytesRead, DWORD *pnMinNumberOfBytesNeeded )
+BOOL32 WINAPI
+ReadEventLog32W( HANDLE32 hEventLog, DWORD dwReadFlags, DWORD dwRecordOffset,
+                 LPVOID lpBuffer, DWORD nNumberOfBytesToRead, 
+                 DWORD *pnBytesRead, DWORD *pnMinNumberOfBytesNeeded )
 {
 	FIXME(advapi,"stub\n");
 	return TRUE;
@@ -176,7 +218,8 @@ HANDLE32 WINAPI RegisterEventSource32A( LPCSTR lpUNCServerName, LPCSTR lpSourceN
  *    Success: Handle
  *    Failure: NULL
  */
-HANDLE32 WINAPI RegisterEventSource32W( LPCWSTR lpUNCServerName, LPCWSTR lpSourceName )
+HANDLE32 WINAPI
+RegisterEventSource32W( LPCWSTR lpUNCServerName, LPCWSTR lpSourceName )
 {
     FIXME(advapi, "(%s,%s): stub\n", debugstr_w(lpUNCServerName),
           debugstr_w(lpSourceName));
@@ -184,7 +227,7 @@ HANDLE32 WINAPI RegisterEventSource32W( LPCWSTR lpUNCServerName, LPCWSTR lpSourc
 }
 
 /******************************************************************************
- * ReportEvent32A			[ADVAPI32.]
+ * ReportEvent32A [ADVAPI32.178]
  */
 BOOL32 WINAPI ReportEvent32A ( HANDLE32 hEventLog, WORD wType, WORD wCategory, DWORD dwEventID,
     PSID lpUserSid, WORD wNumStrings, DWORD dwDataSize, LPCSTR *lpStrings, LPVOID lpRawData)
@@ -194,10 +237,23 @@ BOOL32 WINAPI ReportEvent32A ( HANDLE32 hEventLog, WORD wType, WORD wCategory, D
 }
 
 /******************************************************************************
- * ReportEvent32W			[ADVAPI32.]
+ * ReportEvent32W [ADVAPI32.179]
+ *
+ * PARAMS
+ *   hEventLog   []
+ *   wType       []
+ *   wCategory   []
+ *   dwEventID   []
+ *   lpUserSid   []
+ *   wNumStrings []
+ *   dwDataSize  []
+ *   lpStrings   []
+ *   lpRawData   []
  */
-BOOL32 WINAPI ReportEvent32W ( HANDLE32 hEventLog, WORD wType, WORD wCategory, DWORD dwEventID,
-    PSID lpUserSid, WORD wNumStrings, DWORD dwDataSize, LPCWSTR *lpStrings, LPVOID lpRawData)
+BOOL32 WINAPI
+ReportEvent32W( HANDLE32 hEventLog, WORD wType, WORD wCategory, 
+                DWORD dwEventID, PSID lpUserSid, WORD wNumStrings, 
+                DWORD dwDataSize, LPCWSTR *lpStrings, LPVOID lpRawData )
 {
 	FIXME(advapi,"stub\n");
 	return TRUE;