DsEnumerateDomainTrustsA 関数 (dsgetdc.h)

[アーティクル]
02/26/2024

DsEnumerateDomainTrusts 関数は、指定されたドメインのドメイン信頼データを取得します。

構文

DSGETDCAPI DWORD DsEnumerateDomainTrustsA(
  [in, optional] LPSTR              ServerName,
  [in]           ULONG              Flags,
  [out]          PDS_DOMAIN_TRUSTSA *Domains,
  [out]          PULONG             DomainCount
);

パラメーター

[in, optional] ServerName

信頼情報を取得するドメイン内のコンピューターの名前を指定する null で終わる文字列へのポインター。このパラメーターが NULL の場合は、ローカルコンピューターの名前が使用されます。呼び出し元は、このドメインで認証されたユーザーである必要があります。

このコンピューターがドメインコントローラーの場合、この関数は信頼データを直ちに返します。このコンピューターがドメインコントローラーでない場合、キャッシュされたデータの有効期限が切れていない場合、この関数はキャッシュされたデータから信頼データを取得します。キャッシュされたデータの有効期限が切れている場合、この関数は、このコンピューターがメンバーになっているドメイン内のドメインコントローラーから信頼データを取得し、キャッシュを更新します。キャッシュされたデータは、5 分後に自動的に期限切れになります。

[in] Flags

列挙するドメイン信頼を決定するフラグのセットが含まれます。これは、0 または次の値の 1 つ以上の組み合わせにすることができます。

DS_DOMAIN_DIRECT_INBOUND

ServerName がメンバーであるドメインを直接信頼するドメインを列挙します。

DS_DOMAIN_DIRECT_OUTBOUND

ServerName がメンバーであるドメインによって直接信頼されているドメインを列挙します。

DS_DOMAIN_IN_FOREST

ServerName がメンバーである同じフォレストのメンバーであるドメインを列挙します。

DS_DOMAIN_NATIVE_MODE

プライマリドメインが Windows 2000 ネイティブモードで実行されているドメインを列挙します。

DS_DOMAIN_PRIMARY

ServerName がメンバーであるドメインのプライマリドメインであるドメインを列挙します。

DS_DOMAIN_TREE_ROOT

ServerName がメンバーであるフォレストのルートにあるドメインを列挙します。

[out] Domains

DS_DOMAIN_TRUSTS構造体の配列を受け取るPDS_DOMAIN_TRUSTS値へのポインター。この配列内の各構造体には、ドメインに関する信頼データが含まれています。 NetApiBufferFree を呼び出して不要になった場合、呼び出し元はこのメモリを解放する必要があります。

[out] DomainCount

Domains 配列で返される要素の数を受け取る ULONG 値へのポインター。

戻り値

成功した場合 はERROR_SUCCESS を返し、それ以外の場合は Win32 エラーコードを返します。考えられるエラーコードには、次の一覧に記載されているものが含まれます。

注釈

注意

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

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
対象プラットフォーム	Windows
ヘッダー	dsgetdc.h
Library	Netapi32.lib
[DLL]	Netapi32.dll

こちらもご覧ください

DS_DOMAIN_TRUSTS

ディレクトリサービス関数

NetApiBufferFree

Share via