RegSetKeySecurity 関数 (winreg.h)

[アーティクル]
03/04/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 で定義されている 0 以外のエラーコードが返されます。 FormatMessage 関数を FORMAT_MESSAGE_FROM_SYSTEM フラグと共に使用すると、エラーの一般的な説明を取得できます。

注釈

hKey が定義済みのキーの 1 つである場合は、RegCloseKey 関数を使用して定義済みのキーを閉じて、次に定義済みのキーが参照されるときに新しいセキュリティ情報が有効になるようにします。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	winreg.h (Windows.h を含む)
Library	Advapi32.lib
[DLL]	Advapi32.dll