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 ヘッダー ファイルで定義されている次のいずれかの値を指定できます。
値 | 説明 |
---|---|
|
接続に開いているファイルが存在する場合は、切断に失敗します。 |
|
接続に開いているファイルが存在する場合は、切断に失敗しないでください。 |
|
開いているファイルをすべて閉じ、接続を削除します。 |
戻り値
関数が成功した場合、戻り値は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 |