NetGetAnyDCName 関数 (lmaccess.h)
NetGetAnyDCName 関数は、指定されたサーバーによって直接信頼されているドメインのドメイン コントローラー (DC) の名前を返します。
DNS スタイルの名前をサポートするアプリケーションでは、 DsGetDcName 関数を呼び出す必要があります。 この関数は、ドメインが指定されたサーバーによって直接信頼されているかどうかに関係なく、任意のドメイン内の任意の DC を検索できます。
構文
NET_API_STATUS NET_API_FUNCTION NetGetAnyDCName(
LPCWSTR ServerName,
LPCWSTR DomainName,
LPBYTE *Buffer
);
パラメーター
ServerName
関数を実行するリモート サーバーの DNS または NetBIOS 名を指定する定数文字列へのポインター。 このパラメーターが NULL の場合は、ローカル コンピューターが使用されます。 詳細については、「解説」を参照してください。
DomainName
ドメインの名前を指定する定数文字列へのポインター。 このパラメーターが NULL の場合は、プライマリ ドメインのドメイン コントローラーの名前が使用されます。 詳細については、「解説」を参照してください。
Buffer
戻り値
関数が成功した場合、戻り値はNERR_Success。
関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。
| リターン コード | 説明 |
|---|---|
|
ドメイン コントローラーが見つかりませんでした。 |
|
指定されたドメインが信頼されたドメインではありません。 |
|
信頼関係のクライアント側が壊れています。 |
|
信頼関係のサーバー側が壊れているか、パスワードが壊れています。 |
|
応答したサーバーは、指定されたドメインの適切なドメイン コントローラーではありません。 |
注釈
NetGetAnyDCName 関数を正常に実行するために特別なグループ メンバーシップは必要ありません。
servername がスタンドアロン ワークステーションまたはスタンドアロン サーバーを指定している場合、ドメイン名は有効ではありません。
servername がドメインのメンバーであるワークステーション、またはドメインのメンバーであるサーバーを指定する場合、domainname は servername と同じドメイン内に存在する必要があります。
servername でドメイン コントローラーが指定されている場合、domainname は、サーバーがコントローラーであるドメインによって信頼されるドメインのいずれかである必要があります。 この呼び出しで検出されたドメイン コントローラーは、この呼び出し中に少なくとも 1 回は動作しています。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | lmaccess.h (Include Lm.h) |
| Library | Netapi32.lib |
| [DLL] | Netapi32.dll |