NetServerTransportAdd 関数 (lmserver.h)

NetServerTransportAdd 関数は、サーバーをトランスポートプロトコルにバインドします。

拡張関数 NetServerTransportAddEx を使用すると、呼び出し元のアプリケーションは、SERVER_TRANSPORT_INFO_1、 SERVER_TRANSPORT_INFO_2、およびSERVER_TRANSPORT_INFO_3 情報レベルを指定できます。

構文

NET_API_STATUS NET_API_FUNCTION NetServerTransportAdd(
  [in] LMSTR  servername,
  [in] DWORD  level,
  [in] LPBYTE bufptr
);

[in] servername

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

[in] level

データの情報レベルを指定します。このパラメーターには、次の値を指定できます。

値	意味
0	名前、アドレス、ネットワーク上の場所など、トランスポートプロトコルに関する情報を指定します。 bufptr パラメーターは、SERVER_TRANSPORT_INFO_0構造体を指します。

[in] bufptr

データを含むバッファーへのポインター。

詳細については、「ネットワーク管理関数バッファー」を参照してください。

関数が成功した場合、戻り値はNERR_Success。

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

リターンコード	説明
ERROR_ACCESS_DENIED	ユーザーには、要求された情報へのアクセス権がありません。
ERROR_DUP_NAME	ネットワーク上に重複する名前が存在します。
ERROR_INVALID_DOMAINNAME	ドメイン名がネットワーク上で見つかりませんでした。
ERROR_INVALID_LEVEL	level パラメーターに指定された値が無効です。
ERROR_INVALID_PARAMETER	パラメーターが無効です。このエラーは、bufptr パラメーターが指すSERVER_TRANSPORT_INFO_0構造体のsvti0_transportnameまたはsvti0_transportaddress メンバーが NULL の場合に返されます。このエラーは、bufptr パラメーターが指す SERVER_TRANSPORT_INFO_0 構造体の svti0_transportaddresslength メンバーが、( Windef.h ヘッダーファイルで定義されている) MAX_PATHより 0 以上の場合にも返されます。このエラーは、他の無効なパラメーターについても返されます。
ERROR_NOT_ENOUGH_MEMORY	メモリ不足です。

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

NetServerTransportAdd 関数の呼び出しを使用してサーバーにトランスポートプロトコルを追加した場合、サーバーの再起動または再起動後も接続は維持されません。

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