Hinzufügen einer Netzwerkverbindung

Um eine Verbindung mit einer Netzwerkressource herzustellen, die durch eine NETRESOURCE--Struktur beschrieben wird, kann eine Anwendung die WNetAddConnection2-, die WNetAddConnection3-oder die WNetUseConnection--Funktion aufrufen. Das folgende Beispiel veranschaulicht die Verwendung der WNetAddConnection2--Funktion.

Im Codebeispiel wird die WNetAddConnection2--Funktion aufgerufen, wobei angegeben wird, dass das System das Profil des Benutzers mit den Informationen aktualisieren soll, wodurch eine "gespeicherte" oder dauerhafte Verbindung erstellt wird. Im Beispiel wird ein anwendungsdefinierter Fehlerhandler aufgerufen, um Fehler zu verarbeiten, und die TextOut--Funktion zum Drucken.

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

Die WNetAddConnection--Funktion wird zur Kompatibilität mit früheren Versionen von Windows for Workgroups unterstützt. Neue Anwendungen sollten die WNetAddConnection2--Funktion oder die WNetAddConnection3--Funktion aufrufen.

Weitere Informationen zur Verwendung eines anwendungsdefinierten Fehlerhandlers finden Sie unter Abrufen von Netzwerkfehlern.