ISecurityInformation4::GetSecondarySecurity メソッド (aclui.h)
GetSecondarySecurity メソッドは、リソースへのアクセスに影響を与える可能性のある追加のセキュリティ コンテキストを返します。
構文
HRESULT GetSecondarySecurity(
[out] PSECURITY_OBJECT *pSecurityObjects,
[out] PULONG pSecurityObjectCount
);
パラメーター
[out] pSecurityObjects
成功時 に設定された リソースに関連付けられたセカンダリ セキュリティ オブジェクトを含むSECURITY_OBJECT構造体の配列。 配列は呼び出し元によって所有され、 LocalFree 関数を使用して解放されます。 pwszName メンバーも LocalFree を使用して解放されます。 SECURITY_OBJECT構造体の cbData または cbData2 メンバーがゼロでない場合、呼び出し元は LocalFree を使用して対応する pData または pData2 を解放する必要があります。 これらのメンバーのいずれかが 0 の場合、対応する pData メンバーと pData2 メンバーはリソース マネージャーによって所有され、 EditSecurity 関数が返されるまで有効なままである必要があります
[out] pSecurityObjectCount
成功時に設定される pSecurityObjects パラメーター内のセキュリティ オブジェクトの数。
戻り値
メソッドが成功すると、 S_OKが返されます。
メソッドが失敗すると、エラー コードが返されます。 一般的なエラー コードの一覧については、「 共通の HRESULT 値」を参照してください。
注釈
リソース マネージャーは、 fWellKnown メンバーが TRUE に設定され、 Id メンバーが SECURITY_OBJECT_ID_OBJECT_SD、SECURITY_OBJECT_ID_CENTRAL_POLICY、または SECURITY_OBJECT_ID_CENTRAL_ACCESS_RULE に設定されているセカンダリ オブジェクトを返す必要はありません。 これらの ID を持つセキュリティ オブジェクトは、 ComputeEffectivePermissionWithSecondarySecurity を呼び出すときにアクセス制御エディターによって提供されます。
返されるセキュリティ オブジェクトの解釈は、 ComputeEffectivePermissionWithSecondarySecurity の実装に関連付けられます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | aclui.h |