LookupSecurityDescriptorPartsA 関数 (aclapi.h)

[アーティクル]
11/20/2024

LookupSecurityDescriptorParts 関数は、の自己相対セキュリティ記述子からセキュリティ情報を取得します。

構文

DWORD LookupSecurityDescriptorPartsA(
  [out, optional] PTRUSTEE_A           *ppOwner,
  [out, optional] PTRUSTEE_A           *ppGroup,
  [out, optional] PULONG               pcCountOfAccessEntries,
  [out, optional] PEXPLICIT_ACCESS_A   *ppListOfAccessEntries,
  [out, optional] PULONG               pcCountOfAuditEntries,
  [out, optional] PEXPLICIT_ACCESS_A   *ppListOfAuditEntries,
  [in]            PSECURITY_DESCRIPTOR pSD
);

パラメーター

[out, optional] ppOwner

のトラスティ構造体へのポインターを受け取る変数へのポインター。この関数は、pSDセキュリティ記述子の所有者セキュリティ識別子 (SID) に関連付けられている名前を検索し、のトラスティ 構造体の ptstrName メンバー内の名前へのポインターを返します。この関数は、トラスティフォーム メンバーをTRUSTEE_IS_NAMEに設定します。

所有者の名前に関心がない場合は、このパラメーターを NULL できます。

[out, optional] ppGroup

のトラスティ構造体へのポインターを受け取る変数へのポインター。この関数は、セキュリティ記述子のプライマリグループ SID に関連付けられている名前を検索し、のトラスティ 構造体の ptstrName メンバー内の名前へのポインターを返します。この関数は、トラスティフォーム メンバーをTRUSTEE_IS_NAMEに設定します。

グループの名前に関心がない場合は、このパラメーターを NULL できます。

[out, optional] pcCountOfAccessEntries

pListOfAccessEntries 配列で返される EXPLICIT_ACCESS 構造体の数を受け取る ULONG へのポインター。このパラメーターは、pListOfAccessEntries パラメーターも NULL場合にのみ、NULL できます。

[out, optional] ppListOfAccessEntries

セキュリティ記述子の随意アクセス制御リスト (DACL) のアクセス制御エントリ (ACE) を記述する EXPLICIT_ACCESS 構造体の配列へのポインターを受け取る変数へのポインター。これらの EXPLICIT_ACCESS 構造のトラスティ構造では、TRUSTEE_IS_NAME形式が使用されます。 EXPLICIT_ACCESS 構造体の配列が、アクセス制御リスト (ACL) の ACE を記述する方法については、getExplicitEntriesFromAcl 関数を参照してください。このパラメーターが NULL場合、cCountOfAccessEntries パラメーターも NULLする必要があります。

[out, optional] pcCountOfAuditEntries

pListOfAuditEntries 配列で返される EXPLICIT_ACCESS 構造体の数を受け取る ULONG へのポインター。このパラメーターは、pListOfAuditEntries パラメーターも NULL場合にのみ、NULL できます。

[out, optional] ppListOfAuditEntries

セキュリティ記述子のシステムアクセス制御リスト (SACL) の ACE を記述する EXPLICIT_ACCESS 構造体の配列へのポインターを受け取る変数へのポインター。これらの EXPLICIT_ACCESS 構造のトラスティ構造では、TRUSTEE_IS_NAME形式が使用されます。このパラメーターが NULL場合、cCountOfAuditEntries パラメーターも NULLする必要があります。

[in] pSD

関数がセキュリティ情報を取得する既存の自己相対セキュリティ記述子へのポインター。

戻り値

関数が成功した場合、関数はERROR_SUCCESSを返します。

関数が失敗した場合、WinError.h で定義された 0 以外のエラーコードが返されます。

備考

LookupSecurityDescriptorParts 関数は、セキュリティ記述子の所有者とプライマリグループの名前を取得します。この関数は、DACL の ACE と、セキュリティ記述子の SACL の監査制御エントリの説明も返します。

pSD 以外のパラメーターは、情報に関心がない場合は NULL できます。 DACL に関する情報が必要ない場合は、pListOfAccessEntries と cCountOfAuditEntries の両方を NULLする必要があります。 SACL に関する情報が必要ない場合は、pListOfAuditEntries と cCountOfAuditEntries の両方を NULLする必要があります。同様に、DACL または SACL 情報が必要な場合は、対応するパラメーターの両方を NULLすることはできません。

pOwner、pGroup、pListOfAccessEntries、または pListOfAuditEntries パラメーターによって返されるバッファーの使用が完了したら、LocalFree 関数を呼び出して解放します。

LookupSecurityDescriptorParts 関数は、独自のオブジェクトにセキュリティを実装または公開する信頼されたサーバーを対象としています。この関数は、信頼されたサーバーが必要とする場合があるため、ストリームにシリアル化してディスクに格納するのに適した自己相対セキュリティ記述子で動作します。

手記

aclapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして LookupSecurityDescriptorParts を定義します。エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows XP [デスクトップアプリのみ]
サポートされる最小サーバー	Windows Server 2003 [デスクトップアプリのみ]
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	aclapi.h
ライブラリ	Advapi32.lib
DLL	Advapi32.dll

次の方法で共有

LookupSecurityDescriptorPartsA 関数 (aclapi.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース