NetServerComputerNameAdd 関数 (lmserver.h)

[アーティクル]
08/24/2023

NetServerComputerNameAdd 関数は、指定したサーバーがアクティブなトランスポートを列挙し、エミュレートされたサーバー名を各トランスポートにバインドします。

NetServerComputerNameAdd は、NetServerTransportEnum 関数と NetServerTransportAddEx 関数の機能を組み合わせたユーティリティ関数です。

構文

NET_API_STATUS NET_API_FUNCTION NetServerComputerNameAdd(
  [in] LMSTR ServerName,
  [in] LMSTR EmulatedDomainName,
  [in] LMSTR EmulatedServerName
);

パラメーター

[in] ServerName

関数を実行するリモートサーバーの名前を指定する文字列へのポインター。このパラメーターが NULL の場合は、ローカルコンピューターが使用されます。

[in] EmulatedDomainName

EmulatedServerName を使用して存在を発表するときに、指定したサーバーが使用するドメイン名を含む文字列へのポインター。このパラメーターは省略可能です。

[in] EmulatedServerName

ServerName パラメーターで指定された名前に加えて、サーバーがサポートを開始する必要があるエミュレートされた名前を含む null で終わる文字列へのポインター。

戻り値

関数が成功した場合、戻り値はNERR_Success。指定されたエミュレートされたサーバー名が少なくとも 1 つのトランスポートに追加された場合、 NetServerComputerNameAdd は成功します。

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

リターンコード	説明
ERROR_ACCESS_DENIED	ユーザーには、要求された情報へのアクセス権がありません。
ERROR_DUP_NAME	重複する名前がネットワーク上に存在します。
ERROR_INVALID_DOMAINNAME	ドメイン名がネットワーク上で見つかりませんでした。
ERROR_INVALID_PARAMETER	指定されたパラメーターが無効です。
ERROR_NOT_ENOUGH_MEMORY	十分なメモリがありません。

注釈

NetServerComputerNameAdd 関数を正常に実行できるのは、Administrators または Server Operators ローカルグループのメンバーだけです。

ServerName パラメーターで指定されたサーバーは、サポートされているすべての名前を引き続きサポートし、さらに NetServerComputerNameAdd 関数の正常な呼び出しによって提供される新しい名前のサポートを開始します。

NetServerComputerNameAdd の呼び出しによって発生する名前エミュレーションは、サーバーの再起動または再起動時に停止します。 NetServerComputerNameAdd の前回の呼び出しによって設定された名前エミュレーションを再起動または再起動せずに中止するには、NetServerComputerNameDel 関数を呼び出します。

NetServerComputerNameAdd 関数は、通常、システム管理者がサーバーを置き換えるが、変換をユーザーに対して透過的に保ちたい場合に使用されます。

例

\Server1 も \Server2 の要求に応答するように要求する NetServerComputerNameAdd 関数の呼び出しの例を次に示します。

NetServerComputerNameAdd (Server1, NULL, Server2);

要件

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