ISecurityInformation::GetSecurity メソッド (aclui.h)
GetSecurity メソッドは、セキュリティ記述子が編集されているセキュリティ保護可能なオブジェクトのセキュリティ記述子を要求します。 アクセス制御エディターは、このメソッドを呼び出して、オブジェクトの現在または既定のセキュリティ記述子を取得します。
構文
HRESULT GetSecurity(
[in] SECURITY_INFORMATION RequestedInformation,
[out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
[in] BOOL fDefault
);
パラメーター
[in] RequestedInformation
要求されるセキュリティ 記述子の部分 を示すSECURITY_INFORMATIONビット フラグのセット。 このパラメーターは、次の値と組み合わせて使用できます。
[out] ppSecurityDescriptor
実装でオブジェクトのセキュリティ記述子へのポインターに設定する必要がある変数へのポインター。 セキュリティ記述子には、 RequestedInformation パラメーターによって要求されたコンポーネントを含める必要があります。
システムは LocalFree 関数を呼び出して、返されたポインターを解放します。
[in] fDefault
このパラメーターが TRUE の場合、 ppSecurityDescriptor は オブジェクトのアプリケーション定義の既定のセキュリティ記述子を返す必要があります。 アクセス制御エディターでは、この既定のセキュリティ記述子を使用してプロパティ ページを再初期化します。
アクセス制御エディターは、ユーザーが [既定] ボタンをクリックした場合にのみ、このパラメーターを TRUE に設定します。 [既定値] ボタンは、ISecurityInformation::GetObjectInformation メソッドで SI_RESET フラグを設定した場合にのみ表示されます。 使用できる既定のセキュリティ記述子がない場合は、SI_RESET フラグを設定しないでください。
このフラグが FALSE の場合、 ppSecurityDescriptor はオブジェクトの現在のセキュリティ記述子を返す必要があります。
戻り値
成功した場合は、S_OKを返します。
エラーが発生した場合は、0 以外のエラー コードを返します。 ユーザーが要求されたセキュリティ情報を読み取るアクセス許可を持っていない場合は、E_ACCESSDENIEDを返します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | aclui.h |