DsEnumerateDomainTrustsA 関数 (dsgetdc.h)
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 |