WNetConnectionDialog 関数 (winnetwk.h)
WNetConnectionDialog 関数は、ネットワーク リソースに接続するための一般的な参照ダイアログ ボックスを開始します。 この関数には、ダイアログ ボックスの所有者ウィンドウへのハンドルが必要です。
構文
DWORD WNetConnectionDialog(
[in] HWND hwnd,
[in] DWORD dwType
);
パラメーター
[in] hwnd
ダイアログ ボックスの所有者ウィンドウへのハンドル。
[in] dwType
接続を許可するリソースの種類。 このパラメーターには、次の値を指定できます。
値 | 説明 |
---|---|
|
ディスク リソースへの接続。 |
戻り値
関数が成功した場合、戻り値はNO_ERROR。 ユーザーがダイアログ ボックスをキャンセルすると、関数は –1 を返します。
関数が失敗した場合、戻り値はシステム エラー コード (次のいずれかの値など) になります。
リターン コード | 説明 |
---|---|
|
ネットワーク固有のエラーが発生しました。 エラーの説明を取得するには、 WNetGetLastError 関数を呼び出します。 |
|
指定されたパスワードが無効です。 |
|
ネットワークが利用できません。 |
|
ダイアログ ボックスを起動するためのメモリが不足しています。 |
解説
ユーザーがダイアログ ボックスで [OK] を クリックすると、 WNetConnectionDialog 関数が返されるときに、要求されたネットワーク接続が確立されます。
関数が接続を試行し、ネットワーク プロバイダーからメッセージ ERROR_INVALID_PASSWORDが返された場合、システムはユーザーにパスワードの入力を求めます。 システムは、接続を確立するために別の試行で新しいパスワードを使用します。
要件
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | winnetwk.h |
Library | Mpr.lib |
[DLL] | Mpr.dll |