s3-winreg: fill in some inline comments.

Guenther

1 files changed, 38 insertions, 10 deletions

diff --git a/source3/rpc_server/srv_winreg_nt.c b/source3/rpc_server/srv_winreg_nt.c
index 737554efec..dcfe2b931a 100644
--- a/source3/rpc_server/srv_winreg_nt.c
+++ b/source3/rpc_server/srv_winreg_nt.c
@@ -100,7 +100,7 @@ static bool close_registry_key(pipes_struct *p, struct policy_handle *hnd)
 }
 
 /********************************************************************
- reg_close
+ _winreg_CloseKey
  ********************************************************************/
 
 WERROR _winreg_CloseKey(pipes_struct *p, struct winreg_CloseKey *r)
@@ -116,6 +116,7 @@ WERROR _winreg_CloseKey(pipes_struct *p, struct winreg_CloseKey *r)
 }
 
 /*******************************************************************
+ _winreg_OpenHKLM
  ********************************************************************/
 
 WERROR _winreg_OpenHKLM(pipes_struct *p, struct winreg_OpenHKLM *r)
@@ -124,6 +125,7 @@ WERROR _winreg_OpenHKLM(pipes_struct *p, struct winreg_OpenHKLM *r)
 }
 
 /*******************************************************************
+ _winreg_OpenHKPD
  ********************************************************************/
 
 WERROR _winreg_OpenHKPD(pipes_struct *p, struct winreg_OpenHKPD *r)
@@ -132,6 +134,7 @@ WERROR _winreg_OpenHKPD(pipes_struct *p, struct winreg_OpenHKPD *r)
 }
 
 /*******************************************************************
+ _winreg_OpenHKPT
  ********************************************************************/
 
 WERROR _winreg_OpenHKPT(pipes_struct *p, struct winreg_OpenHKPT *r)
@@ -140,6 +143,7 @@ WERROR _winreg_OpenHKPT(pipes_struct *p, struct winreg_OpenHKPT *r)
 }
 
 /*******************************************************************
+ _winreg_OpenHKCR
  ********************************************************************/
 
 WERROR _winreg_OpenHKCR(pipes_struct *p, struct winreg_OpenHKCR *r)
@@ -148,6 +152,7 @@ WERROR _winreg_OpenHKCR(pipes_struct *p, struct winreg_OpenHKCR *r)
 }
 
 /*******************************************************************
+ _winreg_OpenHKU
  ********************************************************************/
 
 WERROR _winreg_OpenHKU(pipes_struct *p, struct winreg_OpenHKU *r)
@@ -156,6 +161,7 @@ WERROR _winreg_OpenHKU(pipes_struct *p, struct winreg_OpenHKU *r)
 }
 
 /*******************************************************************
+ _winreg_OpenHKCU
  ********************************************************************/
 
 WERROR _winreg_OpenHKCU(pipes_struct *p, struct winreg_OpenHKCU *r)
@@ -164,6 +170,7 @@ WERROR _winreg_OpenHKCU(pipes_struct *p, struct winreg_OpenHKCU *r)
 }
 
 /*******************************************************************
+ _winreg_OpenHKCC
  ********************************************************************/
 
 WERROR _winreg_OpenHKCC(pipes_struct *p, struct winreg_OpenHKCC *r)
@@ -172,6 +179,7 @@ WERROR _winreg_OpenHKCC(pipes_struct *p, struct winreg_OpenHKCC *r)
 }
 
 /*******************************************************************
+ _winreg_OpenHKDD
  ********************************************************************/
 
 WERROR _winreg_OpenHKDD(pipes_struct *p, struct winreg_OpenHKDD *r)
@@ -180,6 +188,7 @@ WERROR _winreg_OpenHKDD(pipes_struct *p, struct winreg_OpenHKDD *r)
 }
 
 /*******************************************************************
+ _winreg_OpenHKPN
  ********************************************************************/
 
 WERROR _winreg_OpenHKPN(pipes_struct *p, struct winreg_OpenHKPN *r)
@@ -188,7 +197,7 @@ WERROR _winreg_OpenHKPN(pipes_struct *p, struct winreg_OpenHKPN *r)
 }
 
 /*******************************************************************
- reg_reply_open_entry
+ _winreg_OpenKey
  ********************************************************************/
 
 WERROR _winreg_OpenKey(pipes_struct *p, struct winreg_OpenKey *r)
@@ -202,7 +211,7 @@ WERROR _winreg_OpenKey(pipes_struct *p, struct winreg_OpenKey *r)
 }
 
 /*******************************************************************
- reg_reply_info
+ _winreg_QueryValue
  ********************************************************************/
 
 WERROR _winreg_QueryValue(pipes_struct *p, struct winreg_QueryValue *r)
@@ -317,7 +326,7 @@ WERROR _winreg_QueryValue(pipes_struct *p, struct winreg_QueryValue *r)
 }
 
 /*****************************************************************************
- Implementation of REG_QUERY_KEY
+ _winreg_QueryInfoKey
  ****************************************************************************/
 
 WERROR _winreg_QueryInfoKey(pipes_struct *p, struct winreg_QueryInfoKey *r)
@@ -353,7 +362,7 @@ WERROR _winreg_QueryInfoKey(pipes_struct *p, struct winreg_QueryInfoKey *r)
 
 
 /*****************************************************************************
- Implementation of REG_GETVERSION
+ _winreg_GetVersion
  ****************************************************************************/
 
 WERROR _winreg_GetVersion(pipes_struct *p, struct winreg_GetVersion *r)
@@ -368,7 +377,7 @@ WERROR _winreg_GetVersion(pipes_struct *p, struct winreg_GetVersion *r)
 
 
 /*****************************************************************************
- Implementation of REG_ENUM_KEY
+ _winreg_EnumKey
  ****************************************************************************/
 
 WERROR _winreg_EnumKey(pipes_struct *p, struct winreg_EnumKey *r)
@@ -394,7 +403,7 @@ WERROR _winreg_EnumKey(pipes_struct *p, struct winreg_EnumKey *r)
 }
 
 /*****************************************************************************
- Implementation of REG_ENUM_VALUE
+ _winreg_EnumValue
  ****************************************************************************/
 
 WERROR _winreg_EnumValue(pipes_struct *p, struct winreg_EnumValue *r)
@@ -455,7 +464,7 @@ WERROR _winreg_EnumValue(pipes_struct *p, struct winreg_EnumValue *r)
 }
 
 /*******************************************************************
- reg_shutdwon
+ _winreg_InitiateSystemShutdown
  ********************************************************************/
 
 WERROR _winreg_InitiateSystemShutdown(pipes_struct *p, struct winreg_InitiateSystemShutdown *r)
@@ -476,7 +485,7 @@ WERROR _winreg_InitiateSystemShutdown(pipes_struct *p, struct winreg_InitiateSys
 }
 
 /*******************************************************************
- reg_shutdown_ex
+ _winreg_InitiateSystemShutdownEx
  ********************************************************************/
 
 #define SHUTDOWN_R_STRING "-r"
@@ -572,7 +581,7 @@ WERROR _winreg_InitiateSystemShutdownEx(pipes_struct *p, struct winreg_InitiateS
 }
 
 /*******************************************************************
- reg_abort_shutdwon
+ _winreg_AbortSystemShutdown
  ********************************************************************/
 
 WERROR _winreg_AbortSystemShutdown(pipes_struct *p, struct winreg_AbortSystemShutdown *r)
@@ -648,6 +657,7 @@ static int validate_reg_filename(TALLOC_CTX *ctx, char **pp_fname )
 }
 
 /*******************************************************************
+ _winreg_RestoreKey
  ********************************************************************/
 
 WERROR _winreg_RestoreKey(pipes_struct *p, struct winreg_RestoreKey *r)
@@ -684,6 +694,10 @@ WERROR _winreg_RestoreKey(pipes_struct *p, struct winreg_RestoreKey *r)
 	return reg_restorekey(regkey, fname);
 }
 
+/*******************************************************************
+ _winreg_SaveKey
+ ********************************************************************/
+
 WERROR _winreg_SaveKey(pipes_struct *p, struct winreg_SaveKey *r)
 {
 	struct registry_key *regkey = find_regkey_by_hnd( p, r->in.handle );
@@ -714,6 +728,7 @@ WERROR _winreg_SaveKey(pipes_struct *p, struct winreg_SaveKey *r)
 }
 
 /*******************************************************************
+ _winreg_SaveKeyEx
  ********************************************************************/
 
 WERROR _winreg_SaveKeyEx(pipes_struct *p, struct winreg_SaveKeyEx *r)
@@ -726,6 +741,7 @@ WERROR _winreg_SaveKeyEx(pipes_struct *p, struct winreg_SaveKeyEx *r)
 }
 
 /*******************************************************************
+ _winreg_CreateKey
  ********************************************************************/
 
 WERROR _winreg_CreateKey( pipes_struct *p, struct winreg_CreateKey *r)
@@ -755,6 +771,7 @@ WERROR _winreg_CreateKey( pipes_struct *p, struct winreg_CreateKey *r)
 }
 
 /*******************************************************************
+ _winreg_SetValue
  ********************************************************************/
 
 WERROR _winreg_SetValue(pipes_struct *p, struct winreg_SetValue *r)
@@ -779,6 +796,7 @@ WERROR _winreg_SetValue(pipes_struct *p, struct winreg_SetValue *r)
 }
 
 /*******************************************************************
+ _winreg_DeleteKey
  ********************************************************************/
 
 WERROR _winreg_DeleteKey(pipes_struct *p, struct winreg_DeleteKey *r)
@@ -793,6 +811,7 @@ WERROR _winreg_DeleteKey(pipes_struct *p, struct winreg_DeleteKey *r)
 
 
 /*******************************************************************
+ _winreg_DeleteValue
  ********************************************************************/
 
 WERROR _winreg_DeleteValue(pipes_struct *p, struct winreg_DeleteValue *r)
@@ -806,6 +825,7 @@ WERROR _winreg_DeleteValue(pipes_struct *p, struct winreg_DeleteValue *r)
 }
 
 /*******************************************************************
+ _winreg_GetKeySecurity
  ********************************************************************/
 
 WERROR _winreg_GetKeySecurity(pipes_struct *p, struct winreg_GetKeySecurity *r)
@@ -848,6 +868,7 @@ WERROR _winreg_GetKeySecurity(pipes_struct *p, struct winreg_GetKeySecurity *r)
 }
 
 /*******************************************************************
+ _winreg_SetKeySecurity
  ********************************************************************/
 
 WERROR _winreg_SetKeySecurity(pipes_struct *p, struct winreg_SetKeySecurity *r)
@@ -874,6 +895,7 @@ WERROR _winreg_SetKeySecurity(pipes_struct *p, struct winreg_SetKeySecurity *r)
 }
 
 /*******************************************************************
+ _winreg_FlushKey
  ********************************************************************/
 
 WERROR _winreg_FlushKey(pipes_struct *p, struct winreg_FlushKey *r)
@@ -885,6 +907,7 @@ WERROR _winreg_FlushKey(pipes_struct *p, struct winreg_FlushKey *r)
 }
 
 /*******************************************************************
+ _winreg_UnLoadKey
  ********************************************************************/
 
 WERROR _winreg_UnLoadKey(pipes_struct *p, struct winreg_UnLoadKey *r)
@@ -897,6 +920,7 @@ WERROR _winreg_UnLoadKey(pipes_struct *p, struct winreg_UnLoadKey *r)
 }
 
 /*******************************************************************
+ _winreg_ReplaceKey
  ********************************************************************/
 
 WERROR _winreg_ReplaceKey(pipes_struct *p, struct winreg_ReplaceKey *r)
@@ -909,6 +933,7 @@ WERROR _winreg_ReplaceKey(pipes_struct *p, struct winreg_ReplaceKey *r)
 }
 
 /*******************************************************************
+ _winreg_LoadKey
  ********************************************************************/
 
 WERROR _winreg_LoadKey(pipes_struct *p, struct winreg_LoadKey *r)
@@ -921,6 +946,7 @@ WERROR _winreg_LoadKey(pipes_struct *p, struct winreg_LoadKey *r)
 }
 
 /*******************************************************************
+ _winreg_NotifyChangeKeyValue
  ********************************************************************/
 
 WERROR _winreg_NotifyChangeKeyValue(pipes_struct *p, struct winreg_NotifyChangeKeyValue *r)
@@ -933,6 +959,7 @@ WERROR _winreg_NotifyChangeKeyValue(pipes_struct *p, struct winreg_NotifyChangeK
 }
 
 /*******************************************************************
+ _winreg_QueryMultipleValues
  ********************************************************************/
 
 WERROR _winreg_QueryMultipleValues(pipes_struct *p, struct winreg_QueryMultipleValues *r)
@@ -945,6 +972,7 @@ WERROR _winreg_QueryMultipleValues(pipes_struct *p, struct winreg_QueryMultipleV
 }
 
 /*******************************************************************
+ _winreg_QueryMultipleValues2
  ********************************************************************/
 
 WERROR _winreg_QueryMultipleValues2(pipes_struct *p, struct winreg_QueryMultipleValues2 *r)