次の方法で共有


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 は成功します。

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

リターン コード 説明
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

こちらもご覧ください

NetServerComputerNameDel

NetServerTransportAdd

NetServerTransportAddEx

NetServerTransportEnum

ネットワーク管理機能

ネットワーク管理の概要

サーバー関数