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 [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | winnetwk.h |
| ライブラリ | Mpr.lib |
| DLL | Mpr.dll |
関連項目
CONNECTDLGSTRUCT の
NETRESOURCE の
WNetConnectionDialog の
WNetDisconnectDialog の