DsEnumerateDomainTrustsA 関数 (dsgetdc.h)

[アーティクル]
11/20/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
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	dsgetdc.h
ライブラリ	Netapi32.lib
DLL	Netapi32.dll

次の方法で共有