次の方法で共有

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。

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

リターン コード 説明
ERROR_ACCESS_DENIED
 呼び出し元は、ネットワーク リソースにアクセスできません。
ERROR_ALREADY_ASSIGNED
 lpDevice で指定されたローカル デバイスは、ネットワーク リソースに既に接続されています。
ERROR_BAD_DEV_TYPE
 ローカル デバイスの種類とネットワーク リソースの種類が一致しません。
ERROR_BAD_DEVICE
 lpDevice で指定された値が無効です。
ERROR_BAD_PROFILE
 ユーザー プロファイルの形式が正しくありません。
ERROR_BUSY
 ルーターまたはプロバイダーがビジー状態で、初期化中である可能性があります。 呼び出し元は再試行する必要があります。
ERROR_CANCELLED
 接続の試行は、ネットワーク リソース プロバイダーの 1 つからのダイアログ ボックスまたは呼び出されたリソースによって、ユーザーによって取り消されました。
ERROR_CANNOT_OPEN_PROFILE
 システムは、永続的な接続を処理するためにユーザー プロファイルを開くことができません。
ERROR_DEVICE_ALREADY_REMEMBERED
 デバイスのエントリは既にユーザー プロファイルにあります。
ERROR_EXTENDED_ERROR
 ネットワーク固有のエラーが発生しました。 WNetGetLastError 関数を呼び出して、エラーの説明を取得します。
ERROR_INVALID_PASSWORD
 指定されたパスワードが無効です。
ERROR_NO_NET_OR_BAD_PATH
 ネットワーク コンポーネントが開始されていないか、指定した名前を使用できないため、操作を実行できません。
ERROR_NO_NETWORK
 ネットワークが利用できません。

注釈

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

こちらもご覧ください

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

Windows ネットワーク関数