WNetConnectionDialog1A 関数 (winnetwk.h)
WNetConnectionDialog1 関数は、ネットワーク リソースに接続するための一般的な参照ダイアログを表示します。 この関数では、ダイアログ ボックスパラメーターを確立するために CONNECTDLGSTRUCT が必要です。
構文
DWORD WNetConnectionDialog1A(
[in, out] LPCONNECTDLGSTRUCTA lpConnDlgStruct
);
パラメーター
[in, out] lpConnDlgStruct
CONNECTDLGSTRUCT 構造体へのポインター。 構造体は、参照ダイアログ パラメーターを確立します。
戻り値
ユーザーがダイアログ ボックスをキャンセルすると、関数は –1 を返します。 関数が成功した場合は、NO_ERRORを返します。 また、呼び出しが成功した場合、CONNECTDLGSTRUCT 構造体の dwDevNum メンバーには、接続されているデバイスの番号が含まれます。
通常、このダイアログは、ユーザーがダイアログ セッションに入ることができない場合にのみエラーを返します。 これは、ダイアログ セッションの後に発生するエラーがユーザーに直接報告されるためです。 関数が失敗した場合、戻り値はシステム エラー コード (次のいずれかの値など) になります。
| リターン コード | 説明 |
|---|---|
|
[CONNDLG_RO_PATH] と [CONNDLG_USE_MRU] ダイアログ ボックスのオプションの両方が設定されます。 (ダイアログ ボックスのオプションは、CONNECTDLGSTRUCT 構造体の dwFlags メンバーによって指定されます)。 \- または - [CONNDLG_PERSIST] と [CONNDLG_NOT_PERSIST] ダイアログ ボックスの両方のオプションが設定されます。 \- または - [CONNDLG_RO_PATH] ダイアログ ボックス オプションが設定され、NETRESOURCE 構造体の lpRemoteName メンバーがリモート ネットワークを指していません。 ( CONNECTDLGSTRUCT 構造体 は NETRESOURCE 構造体を指します)。 |
|
NETRESOURCE 構造体の dwType メンバーは、RESOURCETYPE_DISKに設定されていません。 |
|
ネットワーク プロバイダーがビジー状態です (初期化中の可能性があります)。 呼び出し元は再試行する必要があります。 |
|
ネットワークが利用できません。 |
|
ダイアログ ボックスを表示するためのメモリが不足しています。 |
|
ネットワーク固有のエラーが発生しました。 WNetGetLastError を呼び出して、エラーの説明を取得します。 |
解説
注意
winnetwk.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして WNetConnectionDialog1 を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winnetwk.h |
| Library | Mpr.lib |
| [DLL] | Mpr.dll |