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

関連項目

WNetAddConnection3

WNetCancelConnection2

WNetDisconnectDialog

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

Windows ネットワーク関数