WNetDisconnectDialog1A 関数 (winnetwk.h)
WNetDisconnectDialog1 関数は、ネットワーク リソースの切断を試みます。 基になるネットワークからERROR_OPEN_FILESが返された場合、この関数はユーザーに確認を求めます。 エラーが発生した場合、関数はユーザーに通知します。 この関数では、切断試行のパラメーターを指定するために、DISCDLGSTRUCT が必要です。
構文
DWORD WNetDisconnectDialog1A(
[in] LPDISCDLGSTRUCTA lpConnDlgStruct
);
パラメーター
[in] lpConnDlgStruct
DISCDLGSTRUCT 構造体へのポインター。 構造体は、切断試行の動作を指定します。
戻り値
関数が成功した場合、戻り値はNO_ERROR。 ユーザーがダイアログ ボックスをキャンセルした場合、戻り値は –1 になります。
関数が失敗した場合、戻り値は システム エラー コード(次のいずれかの値など) です。
| リターン コード | 形容 |
|---|---|
|
システムが切断に関する決定をユーザーに求めた場合、ユーザーは切断しないことを選択しました。 |
|
ユーザーが接続をアクティブに使用しているため、切断できません。 |
|
ネットワーク プロバイダーがビジー状態 (場合によっては初期化中) です。 呼び出し元は再試行する必要があります。 |
|
ネットワークは使用できません。 |
|
ダイアログ ボックスを開始するためのメモリが不足しています。 |
|
ネットワーク固有のエラーが発生しました。 WNetGetLastError 関数を呼び出して、エラーの説明を取得します。 |
備考
手記
winnetwk.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして WNetDisconnectDialog1 を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | winnetwk.h |
| ライブラリ | Mpr.lib |
| DLL | Mpr.dll |
関連項目
DISCDLGSTRUCT の
WNetConnectionDialog の
WNetConnectionDialog1 の
WNetDisconnectDialog の