ネットワーク接続の追加

NETRESOURCE 構造体によって記述されたネットワーク リソースに接続するには、アプリケーションで WNetAddConnection2、WNetAddConnection3、または WNetUseConnection 関数を呼び出すことができます。 次の例では、 WNetAddConnection2 関数の使用を示します。

このコード サンプルでは WNetAddConnection2 関数を呼び出し、システムがユーザーのプロファイルを情報で更新し、"記憶済み" または永続的な接続を作成することを指定します。 このサンプルでは、アプリケーション定義のエラー ハンドラーを呼び出してエラーを処理し、 TextOut 関数を使用して印刷します。

DWORD dwResult; 
NETRESOURCE nr; 
//
// Call the WNetAddConnection2 function to make the connection,
//   specifying a persistent connection.
//
dwResult = WNetAddConnection2(&nr, // NETRESOURCE from enumeration 
    (LPSTR) NULL,                  // no password 
    (LPSTR) NULL,                  // logged-in user 
    CONNECT_UPDATE_PROFILE);       // update profile with connect information 
 
// Process errors.
//  The local device is already connected to a network resource.
//
if (dwResult == ERROR_ALREADY_ASSIGNED) 
{ 
    printf("Already connected to specified resource.\n"); 
    return dwResult; 
} 
 
//  An entry for the local device already exists in the user profile.
//
else if (dwResult == ERROR_DEVICE_ALREADY_REMEMBERED) 
{ 
    printf("Attempted reassignment of remembered device.\n"); 
    return dwResult; 
} 
else if(dwResult != NO_ERROR) 
{ 
    //
    // Call an application-defined error handler.
    //
    printf("WNetAddConnection2 failed.\n"); 
    return dwResult; 
} 
 
//
// Otherwise, report a successful connection.
//
printf("Connected to the specified resource.\n"); 

WNetAddConnection 関数は、以前のバージョンの Windows for Workgroup との互換性のためにサポートされています。 新しいアプリケーションでは、 WNetAddConnection2 関数または WNetAddConnection3 関数を呼び出す必要があります。

アプリケーション定義エラー ハンドラーの使用の詳細については、「 ネットワーク エラーの取得」を参照してください。