WNetRestoreConnectionW 関数 (winnetwk.h)
[WNetRestoreConnectionW は Windows Vista の時点では使用できません。]
WNetRestoreConnectionW 関数は、ネットワーク リソースへの接続を復元します。 この関数は、必要に応じてユーザーに名前とパスワードの入力を求めます。
構文
DWORD WNetRestoreConnectionW(
[in] HWND hWnd,
[in] LPCWSTR lpDevice
);
パラメーター
[in] hWnd
ネットワーク接続時にユーザーに名前とパスワードの入力を求めるユーザー インターフェイス (UI) を表示するために関数が使用する親ウィンドウを処理します。 このパラメーターが NULL の場合、所有者ウィンドウはありません。
[in] lpDevice
"Z:" など、接続するドライブのローカル名を指定する null で終わる Unicode 文字列へのポインター。 このパラメーターが NULL の場合、関数は現在のユーザーのレジストリに格納されているすべての永続ドライブを再接続します。
戻り値
関数が成功した場合、戻り値はNO_ERROR。
関数が失敗した場合、戻り値はシステム エラー コード (次のいずれかの値など) になります。
| リターン コード | 説明 |
|---|---|
|
呼び出し元は、ネットワーク リソースにアクセスできません。 |
|
lpDevice で指定されたローカル デバイスは、ネットワーク リソースに既に接続されています。 |
|
ローカル デバイスの種類とネットワーク リソースの種類が一致しません。 |
|
lpDevice で指定された値が無効です。 |
|
ユーザー プロファイルの形式が正しくありません。 |
|
ルーターまたはプロバイダーがビジー状態で、初期化中である可能性があります。 呼び出し元は再試行する必要があります。 |
|
接続の試行は、ネットワーク リソース プロバイダーの 1 つからのダイアログ ボックスまたは呼び出されたリソースによって、ユーザーによって取り消されました。 |
|
システムは、永続的な接続を処理するためにユーザー プロファイルを開くことができません。 |
|
デバイスのエントリは既にユーザー プロファイルにあります。 |
|
ネットワーク固有のエラーが発生しました。 WNetGetLastError 関数を呼び出して、エラーの説明を取得します。 |
|
指定されたパスワードが無効です。 |
|
ネットワーク コンポーネントが開始されていないか、指定した名前を使用できないため、操作を実行できません。 |
|
ネットワークが利用できません。 |
注釈
WNetRestoreConnectionW 関数は、Windows Vista 以降ではサポートされていません。
この関数を呼び出すには、最初に LoadLibrary 関数を呼び出して、Mpr.dll を読み込みます。 次に 、GetProcAddress 関数を呼び出して 、WNetRestoreConnectionW 関数のアドレスを取得します。
WNetRestoreConnectionW は、対話型ログオン プロセス中にすべての永続ドライブ マッピングを復元するために Winlogon によって使用されます。 この関数は、ユーザーの要求に応じて個々のドライブを再接続するために、Microsoft Windows シェルによって呼び出されます。 これは、たとえば、ログオン時にドライブが再接続に失敗し、ユーザーが [マイ コンピューター] 仮想フォルダーの下にあるドライブをダブルクリックした場合などに発生する可能性があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winnetwk.h |
| Library | Mpr.lib |
| [DLL] | Mpr.dll |