RegGetKeySecurity 函式 (winreg.h)

發行項
08/27/2023

RegGetKeySecurity函式會擷取保護指定之開啟登錄機碼的安全描述元複本。

語法

LSTATUS RegGetKeySecurity(
  [in]            HKEY                 hKey,
  [in]            SECURITY_INFORMATION SecurityInformation,
  [out, optional] PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in, out]       LPDWORD              lpcbSecurityDescriptor
);

參數

[in] hKey

要為其擷取安全描述元之開啟金鑰的控制碼。

[in] SecurityInformation

SECURITY_INFORMATION值，指出所要求的安全性資訊。

[out, optional] pSecurityDescriptor

緩衝區的指標，接收所要求之安全描述元的複本。

[in, out] lpcbSecurityDescriptor

變數的指標，指定 pSecurityDescriptor 參數所指向緩衝區的大小，以位元組為單位。當函式傳回時，變數會包含寫入緩衝區的位元組數目。

傳回值

如果函式成功，函式會傳回ERROR_SUCCESS。

如果函式失敗，它會傳回 WinError.h 中定義的非零錯誤碼。您可以使用 FormatMessage 函式搭配 FORMAT_MESSAGE_FROM_SYSTEM 旗標，以取得錯誤的一般描述。

備註

如果 pSecurityDescriptor 參數指定的緩衝區太小，則函式會傳回ERROR_INSUFFICIENT_BUFFER， 而 lkbSecurityDescriptor 參數包含要求之安全性描述元所需的位元組數目。

若要從金鑰的安全性描述項 (DACL) 讀取擁有者、群組或任意存取控制清單，呼叫程式必須在開啟控制碼時授與READ_CONTROL存取權。若要取得READ_CONTROL存取權，呼叫端必須是金鑰的擁有者，或金鑰的 DACL 必須授與存取權。

若要從安全性描述項 (SACL) 讀取系統存取控制清單，呼叫程式必須在開啟金鑰時授與ACCESS_SYSTEM_SECURITY存取權。取得此存取權的正確方式是啟用呼叫端目前權杖中的SE_SECURITY_NAME許可權、開啟ACCESS_SYSTEM_SECURITY存取控制碼，然後停用許可權。

規格需求


最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	winreg.h (包含 Windows.h)
程式庫	Advapi32.lib
Dll	Advapi32.dll