DsGetDomainControllerInfoA 関数 (ntdsapi.h)
DsGetDomainControllerInfo 関数は、ドメイン内のドメイン コントローラーに関するデータを取得します。
構文
NTDSAPI DWORD DsGetDomainControllerInfoA(
[in] HANDLE hDs,
[in] LPCSTR DomainName,
[in] DWORD InfoLevel,
[out] DWORD *pcOut,
[out] VOID **ppInfo
);
パラメーター
[in] hDs
[in] DomainName
ドメイン名を指定する null で終わる文字列へのポインター。
[in] InfoLevel
返す DS_DOMAIN_CONTROLLER_INFO 構造体のバージョンを示す値を格納します。 次のいずれかの値を指定できます。
1
この関数は、ドメイン データを DS_DOMAIN_CONTROLLER_INFO_1 構造形式で提供します。
2
この関数は、ドメイン データを DS_DOMAIN_CONTROLLER_INFO_2 構造体形式で提供します。
3
この関数は、ドメイン データを DS_DOMAIN_CONTROLLER_INFO_3 構造体形式で提供します。
[out] pcOut
ppInfo 配列で返される項目の数を受け取る
[out] ppInfo
DS_DOMAIN_CONTROLLER_INFO_* 構造体の配列を受け取るポインター変数へのポインター。 この配列内の構造体の型は、InfoLevel パラメーター
戻り値
関数がドメイン コントローラー データを返す場合、戻り値は ERROR_SUCCESS。 呼び出し元にサーバー オブジェクトにアクセスする権限がない場合、戻り値は ERROR_SUCCESSされますが、DS_DOMAIN_CONTROLLER_INFO 構造体は空である可能性があります。
関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。
備考
手記
ntdsapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして DsGetDomainControllerInfo を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista |
| サポートされる最小サーバー | Windows Server 2008 |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | ntdsapi.h |
| ライブラリ | Ntdsapi.lib |
| DLL | Ntdsapi.dll |
関連項目
DsBindWithCred の
DsFreeDomainControllerInfo の