RegSetKeySecurity 函式 (winreg.h)

發行項
03/13/2024

RegSetKeySecurity 函式會設定開啟登錄機碼的安全性。

語法

LSTATUS RegSetKeySecurity(
  [in] HKEY                 hKey,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

參數

[in] hKey

已設定安全描述項之開啟金鑰的句柄。

[in] SecurityInformation

一組位旗標，表示要設定的安全性信息類型。這個參數可以是 SECURITY_INFORMATION 位旗標的組合。

[in] pSecurityDescriptor

SECURITY_DESCRIPTOR 結構的指標，指定要為指定索引鍵設定的安全性屬性。

傳回值

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

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

備註

如果 hKey 是其中一個預先定義的金鑰，請使用 RegCloseKey 函式關閉預先定義的金鑰，以確保下次參考預先定義的密鑰時，新的安全性資訊生效。

規格需求

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