Share via


NetServerTransportDel 関数 (lmserver.h)

NetServerTransportDel 関数は、トランスポート プロトコルをサーバーからバインド解除 (または切断) します。 実質的に、サーバーは、指定されたトランスポート プロトコル (TCP や XNS など) を使用してクライアントと通信できなくなります。

構文

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

パラメーター

[in] servername

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

[in] level

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

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

[in] bufptr

データを指定するバッファーへのポインター。 このデータの形式は 、level パラメーターの値によって異なります。 詳細については、「 ネットワーク管理機能バッファー」を参照してください。

戻り値

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

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

リターン コード 説明
ERROR_ACCESS_DENIED
ユーザーには、要求された情報へのアクセス権がありません。
ERROR_INVALID_LEVEL
level パラメーターに指定された値が無効です。
ERROR_INVALID_PARAMETER
指定されたパラメーターが無効です。
ERROR_NOT_ENOUGH_MEMORY
十分なメモリがありません。
NERR_NetNameNotFound
共有名が存在しません。

解説

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

要件

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

関連項目

NetServerTransportAdd

ネットワーク管理機能

ネットワーク管理の概要

SERVER_TRANSPORT_INFO_0

SERVER_TRANSPORT_INFO_1

サーバーとワークステーションのトランスポート機能