WNetDisconnectDialog 関数 (winnetwk.h)

WNetDisconnectDialog 関数は、ネットワークリソースから切断するための一般的な参照ダイアログボックスを開始します。この関数には、ダイアログボックスの所有者ウィンドウへのハンドルが必要です。

構文

DWORD WNetDisconnectDialog(
  [in] HWND  hwnd,
  [in] DWORD dwType
);

[in] hwnd

ダイアログボックスの所有者ウィンドウへのハンドル。

[in] dwType

切断元のリソースの種類。このパラメーターには、次の値を指定できます。

値	説明
RESOURCETYPE_DISK	ディスクリソースから切断します。

関数が成功した場合、戻り値はNO_ERROR。ユーザーがダイアログボックスを取り消すと、戻り値は –1 になります。

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

リターンコード	説明
ERROR_EXTENDED_ERROR	ネットワーク固有のエラーが発生しました。エラーの説明を取得するには、 WNetGetLastError 関数を呼び出します。
ERROR_NO_NETWORK	ネットワークが利用できません。
ERROR_NOT_ENOUGH_MEMORY	ダイアログボックスを起動するためのメモリが不足しています。

WNetDisconnectDialog 関数は直ちにを返し、ネットワークドライブを切断するためのダイアログボックスを作成します。このダイアログボックスは、ワーカースレッドで非同期的に実行されます。

ワーカースレッドが終了すると、所有者ウィンドウとそれに関連付けられているダイアログボックスも終了します。この場合、ダイアログボックスがユーザーの画面に表示されないか、短時間表示されるため、ユーザーがダイアログボックスを操作できない可能性があります。


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