GetSecurityDescriptorOwner 関数 (securitybaseapi.h)

[アーティクル]
03/01/2024

GetSecurityDescriptorOwner 関数は、セキュリティ記述子から所有者情報を取得します。

構文

BOOL GetSecurityDescriptorOwner(
  [in]  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [out] PSID                 *pOwner,
  [out] LPBOOL               lpbOwnerDefaulted
);

パラメーター

[in] pSecurityDescriptor

関数が取得する所有者情報を持つ SECURITY_DESCRIPTOR 構造体へのポインター。

[out] pOwner

関数が戻るときに所有者を識別するセキュリティ識別子 (SID) へのポインターへのポインター。セキュリティ記述子に所有者が含まれていない場合、関数は pOwner が指すポインターを NULL に設定し、残りの出力パラメーター lpbOwnerDefaulted を無視します。セキュリティ記述子に所有者が含まれている場合、関数は pOwner が指すポインターをセキュリティ記述子の所有者 SID のアドレスに設定し、 lpbOwnerDefaulted が指す変数に有効な値を提供します。

[out] lpbOwnerDefaulted

関数が戻るときに、 SECURITY_DESCRIPTOR_CONTROL構造体の SE_OWNER_DEFAULTED フラグの値に設定されるフラグへのポインター。 pOwner パラメーターが指す変数に格納されている値が NULL の場合、値は設定されません。

戻り値

関数が成功した場合、関数は 0 以外の値を返します。

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

要件

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