LsaEnumerateTrustedDomainsEx 関数 (ntsecapi.h)

  • [アーティクル]

LsaEnumerateTrustedDomainsEx 関数は、ローカル システムによって信頼されているドメインに関する情報を返します。LsaEnumerateTrustedDomainsEx は、直接信頼に関する情報のみを返します。 DsEnumerateDomainTrusts は、より完全な信頼列挙の目的で推奨されます。

構文

NTSTATUS LsaEnumerateTrustedDomainsEx(
  [in]  LSA_HANDLE              PolicyHandle,
  [in]  PLSA_ENUMERATION_HANDLE EnumerationContext,
  [out] PVOID                   *Buffer,
  [in]  ULONG                   PreferedMaximumLength,
  [out] PULONG                  CountReturned
);

パラメーター

[in] PolicyHandle

Policy オブジェクトへのハンドル。 この呼び出しには、 Policy オブジェクトへのPOLICY_VIEW_LOCAL_INFORMATIONアクセスが必要です。 詳細については、「 ポリシー オブジェクト ハンドルを開く」を参照してください。

[in] EnumerationContext

LsaEnumerateTrustedDomainsEx を複数回呼び出してすべての信頼されたドメイン情報を取得するために使用できるLSA_ENUMERATION_HANDLEへのポインター。 詳細については、「解説」を参照してください。

[out] Buffer

列挙された信頼されたドメインに関する情報を含む TRUSTED_DOMAIN_INFORMATION_EX 構造体の一覧を受け取るバッファーへのポインター。

アプリケーションは、LsaFreeMemory を呼び出して不要になったときに、このバッファーを解放する必要があります。

[in] PreferedMaximumLength

返されるデータの推奨される最大長 (バイト単位)。 これはハード上限ではありませんが、ガイドとして機能します。 自然データ サイズが異なるシステム間のデータ変換により、返される実際のデータ量がこの値を超える可能性があります。

[out] CountReturned

返された信頼されたドメイン オブジェクトの数を受け取る LONG へのポインター。

戻り値

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

関数が失敗した場合、 NTSTATUS コードが返されます。これは、次の値のいずれか、または LSA ポリシー関数の戻り値のいずれかになります。

値 説明
STATUS_ACCESS_DENIED
 呼び出し元には、操作を完了するための適切なアクセス権がありません。
STATUS_NO_MORE_ENTRIES
 これ以上のエントリはありません。 EnumerationContext 値が大きすぎるため、オブジェクトが列挙されていない場合、この警告が返されます。
 

LsaNtStatusToWinError 関数を使用して、NTSTATUS コードを Windows エラー コードに変換できます。

注釈

すべての信頼情報を取得するには、1 つ以上 の LsaEnumerateTrustedDomainsEx 呼び出しが必要になる場合があります。

EnumerationContext パラメーターを使用して複数の呼び出しを行うには

  1. EnumerationContext が指す変数を 0 に設定します。
  2. LsaEnumerateTrustedDomainsEx がSTATUS_SUCCESSまたはSTATUS_MORE_ENTRIESを返す場合は、関数をもう一度呼び出し、前の呼び出しで返された EnumerationContext 値を渡します。
  3. 列挙は、関数がSTATUS_NO_MORE_ENTRIESを返すときに完了します。

要件

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

こちらもご覧ください

LSA_ENUMERATION_HANDLE

LsaFreeMemory

TRUSTED_DOMAIN_INFORMATION_EX