NetWkstaTransportDel 関数 (lmwksta.h)

  • [アーティクル]

[この関数は廃止されました。 トランスポート プロトコルの既定の設定を手動で変更するには、ネットワークとダイヤルアップ Connections フォルダーの [ローカル エリア接続のプロパティ] ダイアログ ボックスを使用します。

サポートされていません。

NetWkstaTransportDel 関数は、リダイレクターからトランスポート プロトコルのバインドを解除します。 (リダイレクターは、サーバー コンピューターへのファイル要求を生成するクライアント コンピューター上のソフトウェアです)。

構文

NET_API_STATUS NET_API_FUNCTION NetWkstaTransportDel(
  [in] LMSTR servername,
  [in] LMSTR transportname,
  [in] DWORD ucond
);

パラメーター

[in] servername

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

この文字列は、 \で始まる必要があります。

[in] transportname

リダイレクターから切断するトランスポート プロトコルの名前を指定する文字列へのポインター。

[in] ucond

リダイレクターからトランスポート プロトコルを切断するときに使用する強制レベルを指定します。 このパラメーターには、次の値のいずれかを指定できます。

値 意味
USE_NOFORCE
 接続に開いているファイルが存在する場合は、切断に失敗します。
USE_FORCE
 接続に開いているファイルが存在する場合は、切断に失敗します。
USE_LOTS_OF_FORCE
 開いているファイルをすべて閉じ、接続を削除します。

戻り値

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

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

リターン コード 説明
ERROR_ACCESS_DENIED
 ユーザーには、要求された情報へのアクセス権がありません。
ERROR_INVALID_PARAMETER
 関数パラメーターの 1 つが無効です。
NERR_UseNotFound
 ネットワーク接続が存在しません。

注釈

Administrators ローカル グループのメンバーのみが NetWkstaTransportDel 関数を正常に実行できます。

要件

要件 値
対象プラットフォーム Windows
ヘッダー lmwksta.h (include Lm.h, Lmwksta.h)
Library Netapi32.lib
[DLL] Netapi32.dll