Share via


ネットワーク接続の取り消し

ネットワーク リソースへの接続を取り消すには、次の例に示すように、アプリケーションで WNetCancelConnection2 関数を呼び出すことができます。

WNetCancelConnection2 の呼び出しは、ネットワーク接続が永続的でなくなることを指定します。 このサンプルでは、アプリケーション定義のエラー ハンドラーを呼び出してエラーを処理し、 TextOut 関数を印刷します。

DWORD dwResult; 
 
// Call the WNetCancelConnection2 function, specifying
//  that the connection should no longer be a persistent one.
//
dwResult = WNetCancelConnection2("z:", 
    CONNECT_UPDATE_PROFILE, // remove connection from profile 
    FALSE);                 // fail if open files or jobs 
 
// Process errors.
//  The device is not a local redirected device.
//
if (dwResult == ERROR_NOT_CONNECTED) 
{ 
    printf("Drive z: not connected.\n"); 
    return dwResult; 
} 
 
// Call an application-defined error handler.
//
else if(dwResult != NO_ERROR) 
{ 
    printf("WNetCancelConnection2 failed.\n"); 
    return dwResult; 
}
//
// Otherwise, report canceling the connection.
//
printf("Connection closed for z: drive.\n"); 

WNetCancelConnection 関数は、以前のバージョンの Windows for Workgroups との互換性のためにサポートされています。 新しいアプリケーションの場合は、 WNetCancelConnection2 を使用します。

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