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

SetSecurity メソッドは、ユーザーがセキュリティ保護可能なオブジェクトに適用するセキュリティ情報を含むセキュリティ記述子を提供します。アクセス制御エディターは、ユーザーが [Ok] または [ 適用] をクリックしたときに、このメソッドを呼び出します。

構文

HRESULT SetSecurity(
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

[in] SecurityInformation

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

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

[in] pSecurityDescriptor

新しいセキュリティ情報を含むセキュリティ記述子へのポインター。セキュリティ記述子が自己相対形式であると想定しないでください。絶対または自己相対のいずれかを指定できます。

成功した場合はS_OKを返します。

エラーが発生した場合は、0 以外のエラーコードを返します。

オブジェクトの完全なセキュリティ記述子を構築するには、 SecurityInformation パラメーターで定義されている新しいセキュリティ記述子パーツをオブジェクトの既存のセキュリティ記述子にマージする必要があります。