WNetConnectionDialog 関数 (winnetwk.h)

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

構文

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

[in] hwnd

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

[in] dwType

接続を許可するリソースの種類。このパラメーターには、次の値を指定できます。

値	説明
RESOURCETYPE_DISK	ディスクリソースへの接続。

関数が成功した場合、戻り値はNO_ERROR。ユーザーがダイアログボックスをキャンセルすると、関数は –1 を返します。

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

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

ユーザーがダイアログボックスで [OK] を クリックすると、 WNetConnectionDialog 関数が返されるときに、要求されたネットワーク接続が確立されます。

関数が接続を試行し、ネットワークプロバイダーからメッセージ ERROR_INVALID_PASSWORDが返された場合、システムはユーザーにパスワードの入力を求めます。システムは、接続を確立するために別の試行で新しいパスワードを使用します。


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