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 の実装に関連付けられます。

要件

こちらもご覧ください

ISecurityInformation4