CreateSecurityPage 関数 (aclui.h)

[アーティクル]
02/23/2024

CreateSecurityPage 関数は、オブジェクトの随意アクセス制御リスト (DACL) のアクセス制御エントリ (ACE) によって許可または拒否されたアクセス権をユーザーが表示および編集できるようにする基本的なセキュリティプロパティページを作成します。 PropertySheet 関数またはPSM_ADDPAGE メッセージを使用して、このページをプロパティシートに追加します。

構文

HPROPSHEETPAGE ACLUIAPI CreateSecurityPage(
  [in] LPSECURITYINFO psi
);

パラメーター

[in] psi

ISecurityInformation インターフェイスの実装へのポインター。システムはインターフェイスメソッドを呼び出して、編集中のオブジェクトに関する情報を取得し、ユーザーの入力を返します。

戻り値

関数が成功した場合、関数は基本的なセキュリティプロパティページへのハンドルを返します。

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

解説

プロパティページの初期化中に、システムは ISecurityInformation::GetSecurity メソッドと ISecurityInformation::SetSecurity メソッドを呼び出して、ユーザーがオブジェクトのセキュリティ記述子を編集するアクセス許可を持っているかどうかを判断します。ユーザーにアクセス許可がない場合は、エラーメッセージが表示されます。

基本的なセキュリティプロパティページには、高度なセキュリティプロパティシートを表示するための [詳細設定] ボタンを含めることができます。この高度なセキュリティプロパティシートには、ユーザーがオブジェクトの DACL、システムアクセス制御リスト (SACL)、所有者を表示および編集できるようにする 3 つの追加プロパティページを含めることができます。

要件

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