Dodawanie połączenia sieciowego

Aby nawiązać połączenie z zasobem sieciowym opisanym przez strukturę NETRESOURCE, aplikacja może wywołać funkcję WNetAddConnection2, WNetAddConnection3lub funkcję WNetUseConnection. W poniższym przykładzie pokazano użycie funkcji WNetAddConnection2.

Przykładowy kod wywołuje funkcję WNetAddConnection2, określając, że system powinien zaktualizować profil użytkownika przy użyciu informacji, tworząc "zapamiętane" lub trwałe połączenie. Przykład wywołuje obsługę błędów zdefiniowaną przez aplikację do przetwarzania błędów, a funkcję TextOut do drukowania.

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

Funkcja WNetAddConnection jest obsługiwana w celu zachowania zgodności z wcześniejszymi wersjami grup roboczych systemu Windows. Nowe aplikacje powinny wywoływać funkcję WNetAddConnection2 lub funkcję WNetAddConnection3.

Aby uzyskać więcej informacji na temat korzystania z procedury obsługi błędów zdefiniowanej przez aplikację, zobacz Pobieranie błędów sieci.