Een netwerkverbinding toevoegen

Als u een verbinding wilt maken met een netwerkresource die wordt beschreven door een NETRESOURCE structuur, kan een toepassing de WNetAddConnection2-, de WNetAddConnection3-of de WNetUseConnection--functie aanroepen. In het volgende voorbeeld wordt het gebruik van de WNetAddConnection2--functie gedemonstreerd.

In het codevoorbeeld wordt de WNetAddConnection2--functie aangeroepen, waarbij wordt opgegeven dat het systeem het profiel van de gebruiker moet bijwerken met de informatie, waardoor een 'onthouden' of permanente verbinding wordt gemaakt. In het voorbeeld wordt een door de toepassing gedefinieerde fouthandler aangeroepen voor het verwerken van fouten en de functie TextOut- voor afdrukken.

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

De functie WNetAddConnection wordt ondersteund voor compatibiliteit met eerdere versies van Windows for Workgroups. Nieuwe toepassingen moeten de functie WNetAddConnection2 of de functie WNetAddConnection3 aanroepen.

Zie Netwerkfouten ophalenvoor meer informatie over het gebruik van een door de toepassing gedefinieerde fouthandler.