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。

関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。

リターン コード 説明
ERROR_NO_LOGON_SERVERS
ドメイン コントローラーが見つかりませんでした。
ERROR_NO_SUCH_DOMAIN
指定されたドメインが信頼されたドメインではありません。
ERROR_NO_TRUST_LSA_SECRET
信頼関係のクライアント側が壊れています。
ERROR_NO_TRUST_SAM_ACCOUNT
信頼関係のサーバー側が壊れているか、パスワードが壊れています。
ERROR_DOMAIN_TRUST_INCONSISTENT
応答したサーバーは、指定されたドメインの適切なドメイン コントローラーではありません。

注釈

NetGetAnyDCName 関数を正常に実行するために特別なグループ メンバーシップは必要ありません。

servername がスタンドアロン ワークステーションまたはスタンドアロン サーバーを指定している場合、ドメイン名は有効ではありません。

servername がドメインのメンバーであるワークステーション、またはドメインのメンバーであるサーバーを指定する場合、domainnameservername と同じドメイン内に存在する必要があります。

servername でドメイン コントローラーが指定されている場合、domainname は、サーバーがコントローラーであるドメインによって信頼されるドメインのいずれかである必要があります。 この呼び出しで検出されたドメイン コントローラーは、この呼び出し中に少なくとも 1 回は動作しています。

要件

要件
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー lmaccess.h (Include Lm.h)
Library Netapi32.lib
[DLL] Netapi32.dll

こちらもご覧ください

DsGetDcName

関数を取得する

NetGetDCName

ネットワーク管理機能

ネットワーク管理の概要