ORGetKeySecurity 関数
オフライン レジストリ ハイブで指定された開いているレジストリ キーを保護するセキュリティ記述子のコピーを取得します。
構文
DWORD ORGetKeySecurity(
_In_ ORHKEY Handle,
_In_ SECURITY_INFORMATION SecurityInformation,
_Out_opt_ PSECURITY_DESCRIPTOR pSecurityDescriptor,
_Inout_ PDWORD lpcbSecurityDescriptor
);
パラメーター
-
ハンドル [入力]
-
オフライン レジストリ ハイブで開いているレジストリ キーへのハンドル。
-
SecurityInformation [in]
-
要求されたセキュリティ情報を示す SECURITY_INFORMATION 値。
-
pSecurityDescriptor [out, optional]
-
要求されたセキュリティ記述子のコピーを受け取るバッファーへのポインター。 このパラメーターは、NULL でもかまいません。
-
lpcbSecurityDescriptor [in, out]
-
pSecurityDescriptor パラメーターによって指されるバッファーのサイズをバイト単位で指定する変数へのポインター。 関数が戻るとき、変数にはバッファーに書き込まれたバイト数が含まれます。
戻り値
関数が成功した場合、関数はERROR_SUCCESSを返します。
関数が失敗した場合、Winerror.h で定義されている 0 以外のエラー コードが返されます。 FormatMessage 関数を FORMAT_MESSAGE_FROM_SYSTEM フラグと共に使用すると、エラーの一般的な説明を取得できます。
pSecurityDescriptor パラメーターで指定されたバッファーが小さすぎる場合、関数は ERROR_INSUFFICIENT_BUFFERを返し、lpcbSecurityDescriptor パラメーターには要求されたセキュリティ記述子に必要なバイト数が含まれます。
要件
| 要件 | 値 |
|---|---|
| 再頒布可能パッケージ |
Windows オフライン レジストリ ライブラリ バージョン 1.0 以降 |
| ヘッダー |
|
| [DLL] |
|
関連項目