ISecurityInformation::GetSecurity メソッド (aclui.h)

  • [アーティクル]

GetSecurity メソッドは、セキュリティ記述子が編集されているセキュリティ保護可能なオブジェクトのセキュリティ記述子を要求します。 アクセス制御エディターは、このメソッドを呼び出して、オブジェクトの現在または既定のセキュリティ記述子を取得します。

構文

HRESULT GetSecurity(
  [in]  SECURITY_INFORMATION RequestedInformation,
  [out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
  [in]  BOOL                 fDefault
);

パラメーター

[in] RequestedInformation

要求されるセキュリティ 記述子の部分 を示すSECURITY_INFORMATIONビット フラグのセット。 このパラメーターは、次の値と組み合わせて使用できます。

値 意味
OWNER_SECURITY_INFORMATION
 セキュリティ記述子には、オブジェクトの所有者の SID を含める必要があります。
GROUP_SECURITY_INFORMATION
 セキュリティ記述子には、オブジェクトのプライマリ グループの SID を含める必要があります。
DACL_SECURITY_INFORMATION
 セキュリティ記述子には、オブジェクトの DACL を含める必要があります。
SACL_SECURITY_INFORMATION
 セキュリティ記述子には、オブジェクトの SACL を含める必要があります。

[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

こちらもご覧ください

Access Control エディター

Access Control エディター関数

ISecurityInformation

ISecurityInformation::GetObjectInformation

LocalFree

SECURITY_INFORMATION