NetGetAnyDCName 関数 (lmaccess.h)

[アーティクル]
03/05/2024

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

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

要件

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