NetServerComputerNameAdd 関数 (lmserver.h)
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 は成功します。
関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。
| リターン コード | 説明 |
|---|---|
|
ユーザーには、要求された情報へのアクセス権がありません。 |
|
重複する名前がネットワーク上に存在します。 |
|
ドメイン名がネットワーク上で見つかりませんでした。 |
|
指定されたパラメーターが無効です。 |
|
十分なメモリがありません。 |
注釈
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 |