GetKernelObjectSecurity 関数 (securitybaseapi.h)

[アーティクル]
08/25/2023

GetKernelObjectSecurity 関数は、カーネルオブジェクトを保護するセキュリティ記述子のコピーを取得します。

構文

BOOL GetKernelObjectSecurity(
  [in]            HANDLE               Handle,
  [in]            SECURITY_INFORMATION RequestedInformation,
  [out, optional] PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in]            DWORD                nLength,
  [out]           LPDWORD              lpnLengthNeeded
);

パラメーター

[in] Handle

カーネルオブジェクトへのハンドル。

[in] RequestedInformation

要求されるセキュリティ情報を識別する SECURITY_INFORMATION 値を指定します。

[out, optional] pSecurityDescriptor

関数が指定したオブジェクトのセキュリティ記述子のコピーを格納するバッファーへのポインター。呼び出し元プロセスには、オブジェクトのセキュリティ状態の指定された側面を表示する権限が必要です。 SECURITY_DESCRIPTOR構造体は自己相対形式で返されます。

[in] nLength

pSecurityDescriptor パラメーターが指すバッファーのサイズをバイト単位で指定します。

[out] lpnLengthNeeded

pSecurityDescriptor パラメーターによって指されるバッファーに必要なバイト数を受け取る変数へのポインター。関数が戻るときにこの変数の値が nLength パラメーターの値より大きい場合、どのセキュリティ記述子もバッファーにコピーされます。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

カーネルオブジェクトのセキュリティ記述子から所有者、グループ、または DACL を読み取るために、呼び出し元のプロセスには、ハンドルが開かれたときにREAD_CONTROLアクセス権が付与されている必要があります。 READ_CONTROLアクセスを取得するには、呼び出し元がオブジェクトの所有者であるか、オブジェクトの DACL がアクセス権を付与する必要があります。

セキュリティ記述子から SACL を読み取るために、呼び出し元のプロセスに、ハンドルが開かれたときにアクセスACCESS_SYSTEM_SECURITY許可されている必要があります。このアクセスを取得する適切な方法は、呼び出し元の現在のトークンでSE_SECURITY_NAME特権を有効にし、ACCESS_SYSTEM_SECURITYアクセスのハンドルを開き、特権を無効にすることです。

要件

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