WNetConnectionDialog1A 関数 (winnetwk.h)

WNetConnectionDialog1 関数は、ネットワーク リソースに接続するための一般的な参照ダイアログを表示します。 この関数では、ダイアログ ボックスパラメーターを確立するために CONNECTDLGSTRUCT が必要です。

構文

DWORD WNetConnectionDialog1A(
  [in, out] LPCONNECTDLGSTRUCTA lpConnDlgStruct
);

パラメーター

[in, out] lpConnDlgStruct

CONNECTDLGSTRUCT 構造体へのポインター。 構造体は、参照ダイアログ パラメーターを確立します。

戻り値

ユーザーがダイアログ ボックスをキャンセルすると、関数は –1 を返します。 関数が成功した場合は、NO_ERRORを返します。 また、呼び出しが成功した場合、CONNECTDLGSTRUCT 構造体の dwDevNum メンバーには、接続されているデバイスの番号が含まれます。

通常、このダイアログは、ユーザーがダイアログ セッションに入ることができない場合にのみエラーを返します。 これは、ダイアログ セッションの後に発生するエラーがユーザーに直接報告されるためです。 関数が失敗した場合、戻り値はシステム エラー コード (次のいずれかの値など) になります。

リターン コード 説明
ERROR_INVALID_PARAMETER
[CONNDLG_RO_PATH] と [CONNDLG_USE_MRU] ダイアログ ボックスのオプションの両方が設定されます。 (ダイアログ ボックスのオプションは、CONNECTDLGSTRUCT 構造体の dwFlags メンバーによって指定されます)。

\- または -

[CONNDLG_PERSIST] と [CONNDLG_NOT_PERSIST] ダイアログ ボックスの両方のオプションが設定されます。

\- または -

[CONNDLG_RO_PATH] ダイアログ ボックス オプションが設定され、NETRESOURCE 構造体の lpRemoteName メンバーがリモート ネットワークを指していません。 ( CONNECTDLGSTRUCT 構造体NETRESOURCE 構造体を指します)。

ERROR_BAD_DEV_TYPE
NETRESOURCE 構造体の dwType メンバーは、RESOURCETYPE_DISKに設定されていません。
ERROR_BUSY
ネットワーク プロバイダーがビジー状態です (初期化中の可能性があります)。 呼び出し元は再試行する必要があります。
ERROR_NO_NETWORK
ネットワークが利用できません。
ERROR_NOT_ENOUGH_MEMORY
ダイアログ ボックスを表示するためのメモリが不足しています。
ERROR_EXTENDED_ERROR
ネットワーク固有のエラーが発生しました。 WNetGetLastError を呼び出して、エラーの説明を取得します。

解説

注意

winnetwk.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして WNetConnectionDialog1 を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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

関連項目

CONNECTDLGSTRUCT

NETRESOURCE

WNetConnectionDialog

WNetDisconnectDialog

Windows ネットワーク (WNet) の概要

Windows ネットワーク関数