Přidání síťového připojení

Pokud chcete vytvořit připojení k síťovému prostředku, který popisuje struktura NETRESOURCE, může aplikace volat funkci WNetAddConnection2, WNetAddConnection3nebo WNetUseConnection. Následující příklad ukazuje použití WNetAddConnection2 funkce.

Vzorový kód volá funkci WNetAddConnection2, která určuje, že by systém měl aktualizovat profil uživatele informacemi a vytvořit "zapamatované" nebo trvalé připojení. Ukázka volá aplikací definovanou obslužnou rutinu chyby pro zpracování chyb a funkci TextOut pro tisknutí.

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"); 

Funkce WNetAddConnection je podporována z důvodu kompatibility se staršími verzemi Windows for Workgroups. Nové aplikace by měly volat funkci WNetAddConnection2 nebo funkci WNetAddConnection3.

Další informace o použití aplikací definovaného zpracovatele chyb viz Načítání chyb sítě.