WNetUseConnectionA 関数 (winnetwk.h)

WNetUseConnection 関数は、ネットワーク リソースに接続します。 この関数は、ローカル デバイスをネットワーク リソースにリダイレクトできます。

WNetUseConnection 関数は、WNetAddConnection3 関数に似ています。 主な違いは、WNetUseConnection 、ネットワーク リソースにリダイレクトする未使用のローカル デバイスを自動的に選択できることです。

構文

DWORD WNetUseConnectionA(
  [in]      HWND           hwndOwner,
  [in]      LPNETRESOURCEA lpNetResource,
  [in]      LPCSTR         lpPassword,
  [in]      LPCSTR         lpUserId,
  [in]      DWORD          dwFlags,
  [out]     LPSTR          lpAccessName,
  [in, out] LPDWORD        lpBufferSize,
  [out]     LPDWORD        lpResult
);

パラメーター

[in] hwndOwner

ネットワーク リソースのプロバイダーがダイアログ ボックスの所有者ウィンドウとして使用できるウィンドウを処理します。 dwFlags パラメーターにCONNECT_INTERACTIVE値を設定する場合は、このパラメーターを使用します。

[in] lpNetResource

提案された接続の詳細を指定する NETRESOURCE 構造体へのポインター。 構造体には、ネットワーク リソース、ローカル デバイス、およびネットワーク リソース プロバイダーに関する情報が含まれています。

NETRESOURCE 構造体の次のメンバーを指定する必要があります。

WNetUseConnection 関数は、NETRESOURCE 構造体の他のメンバーを無視します。 詳細については、dwFlags パラメーターについては、次の説明を参照してください。

[in] lpPassword

ネットワーク接続 使用するパスワードを指定する null-terminated 文字列を指す定数へのポインター。

lpPassword が NULL場合、この関数は lpUserIDで指定されたユーザーに関連付けられている現在の既定のパスワード 使用します。

lpPassword が空の文字列を指している場合、関数はパスワードを使用しません。

無効なパスワードが原因で接続に失敗し、dwFlags パラメーターにCONNECT_INTERACTIVE値が設定されている場合、この関数はユーザーにパスワードの入力を求めるダイアログ ボックスを表示します。

[in] lpUserId

接続を確立するためのユーザー名を指定する null-terminated 文字列 定数へのポインター。

lpUserID が NULL場合、この関数は既定のユーザー名を使用します。 (プロセスのユーザー コンテキストは、既定のユーザー名を提供します)。

lpUserID パラメーターは、ユーザーに既定のユーザー名またはアカウント以外のユーザー名またはアカウントが割り当てられているネットワーク リソースに接続する場合に指定します。

ユーザー名の文字列は、セキュリティ コンテキストを表します。 ネットワーク プロバイダーに固有の場合があります。

[in] dwFlags

接続を記述するビット フラグのセット。 このパラメーターには、次の値を任意に組み合わせて使用できます。

[out] lpAccessName

接続でシステム要求を受信するバッファーへのポインター。 このパラメーターは NULLできます。

このパラメーターを指定し、NETRESOURCE 構造体の lpLocalName メンバーがローカル デバイスを指定する場合、このバッファーはローカル デバイス名を受け取ります。 lpLocalName がデバイスを指定せず、ネットワークでローカル デバイスのリダイレクトが必要な場合、またはCONNECT_REDIRECT値が設定されている場合、このバッファーはリダイレクトされたローカル デバイスの名前を受け取ります。

それ以外の場合、バッファーにコピーされる名前はリモート リソースの名前になります。 指定する場合、このバッファーは、lpRemoteName メンバーが指す文字列と同じ大きさにする必要があります。

[in, out] lpBufferSize

lpAccessName バッファーのサイズを文字で指定する変数へのポインター。 バッファーが十分な大きさではないために呼び出しが失敗した場合、関数はこの場所で必要なバッファー サイズを返します。 詳細については、「戻り値」セクションの lpAccessName パラメーターとERROR_MORE_DATAエラー・コードの説明を参照してください。

[out] lpResult

接続に関する追加情報を受け取る変数へのポインター。 このパラメーターには、次の値を指定できます。

戻り値

関数が成功した場合、戻り値はNO_ERROR。

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

備考

Windows Server 2003 および Windows XP: WNet 関数は、MS-DOS デバイスが AuthenticationID によって識別されるため、ログオン セッションに関連付けられている MS-DOS デバイス名前空間でネットワーク ドライブ文字を作成および削除します。 (AuthenticationID は、ログオン セッションに関連付けられた ローカル一意識別子 (LUID)です)。これは、いずれかの WNet 関数を呼び出して 1 人のユーザー ログオンでネットワーク ドライブ文字を作成するが、別のユーザー ログオンで既存のネットワーク ドライブ文字を照会するアプリケーションに影響を与える可能性があります。 このような状況の例としては、たとえば、CreateProcessAsUser 関数を呼び出すことによって、ログオン セッション内にユーザーの 2 番目のログオンが作成され、2 番目のログオンで、GetLogicalDrives 関数を呼び出すアプリケーションが実行される場合があります。 GetLogicalDrives は、最初のログオン時に WNet 関数によって作成されたネットワーク ドライブ文字を返しません。 前の例では、最初のログオン セッションがまだ存在し、ターミナル サービス セッションを含む任意のログオン セッションにこの例を適用できることに注意してください。 詳細については、「MS-DOS デバイス名の定義 」を参照してください。

必要条件

関連項目

WNetAddConnection2 の

WNetAddConnection3 の

WNetGetConnection の

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

Windows ネットワーク機能の

WnetCancelConnection