NetUseDel 関数 (lmuse.h)

  • [アーティクル]

NetUseDel 関数は、共有リソースへの接続を終了します。

WNetCancelConnection2 関数を使用して、ネットワーク接続を終了することもできます。

構文

NET_API_STATUS NET_API_FUNCTION NetUseDel(
  [in] LMSTR UncServerName,
  [in] LMSTR UseName,
  [in] DWORD ForceLevelFlags
);

パラメーター

[in] UncServerName

この関数を実行するコンピューターの UNC 名。 これがパラメーターが NULL の場合は、ローカル コンピューターが使用されます。

指定された UncServerName パラメーターがリモート コンピューターの場合、リモート コンピューターは、従来のリモート アクセス プロトコル メカニズムを使用してリモート RPC 呼び出しをサポートする必要があります。

_WIN32_WINNTまたはFORCE_UNICODEが定義されている場合、この文字列は Unicode です。

[in] UseName

削除する接続のパスを指定する文字列へのポインター。

_WIN32_WINNTまたはFORCE_UNICODEが定義されている場合、この文字列は Unicode です。

[in] ForceLevelFlags

接続の削除に使用する力のレベル。

このパラメーターには、 lmuseflg.h ヘッダー ファイルで定義されている次のいずれかの値を指定できます。

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

戻り値

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

関数が失敗した場合、戻り値はシステム エラー コードです。 エラー コードの一覧については、「 システム エラー コード」を参照してください。

解説

NetUseDel 関数は、サーバー メッセージ ブロック (LAN マネージャー ワークステーション) クライアントにのみ適用されます。 NetUseDel 関数は、分散ファイル システム (DFS) 共有やその他のネットワーク ファイル システムをサポートしていません。 別のネットワーク プロバイダー (WebDAV や DFS 共有など) を使用して共有への接続を終了するには、 WNetCancelConnection2 関数を使用します。

NetUseDel 関数を呼び出すために特別なグループ メンバーシップは必要ありません。 ダウンレベル互換性がある場合を除き、リモート サーバーでこの関数を実行することはできません。

要件

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

関連項目

NetUseAdd

ネットワーク管理機能

ネットワーク管理の概要

関数を使用する

WNetCancelConnection2