WNetCancelConnectionA-Funktion (winnetwk.h)
Die WNetCancelConnection Funktion bricht eine vorhandene Netzwerkverbindung ab.
Die WNetCancelConnection--Funktion wird zur Kompatibilität mit 16-Bit-Versionen von Windows bereitgestellt. Andere Windows-basierte Anwendungen sollten die WNetCancelConnection2--Funktion aufrufen.
Syntax
DWORD WNetCancelConnectionA(
[in] LPCSTR lpName,
[in] BOOL fForce
);
Parameter
[in] lpName
Zeigen Sie auf eine konstante null-beendete Zeichenfolge, die den Namen des umgeleiteten lokalen Geräts oder der Remotenetzwerkressource angibt, von der die Verbindung getrennt werden soll.
Wenn dieser Parameter ein umgeleitetes lokales Gerät angibt, bricht die Funktion nur die angegebene Geräteumleitung ab. Wenn der Parameter eine Remotenetzwerkressource angibt, werden nur die Verbindungen zu Remotenetzwerken ohne Geräte abgebrochen.
[in] fForce
Gibt an, ob die Verbindung auftreten soll, wenn die Verbindung geöffnete Dateien oder Aufträge enthält. Wenn dieser Parameter FALSEist, schlägt die Funktion fehl, wenn geöffnete Dateien oder Aufträge vorhanden sind.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode, z. B. einer der folgenden Werte.
| Rückgabecode | Beschreibung |
|---|---|
|
Das Benutzerprofil weist ein falsches Format auf. |
|
Das System kann das Benutzerprofil nicht öffnen, um dauerhafte Verbindungen zu verarbeiten. |
|
Das Gerät wird von einem aktiven Prozess verwendet und kann nicht getrennt werden. |
|
Es ist ein netzwerkspezifischer Fehler aufgetreten. Rufen Sie zum Abrufen einer Beschreibung des Fehlers die WNetGetLastError--Funktion auf. |
|
Der durch den parameter lpName Parameter angegebene Name ist kein umgeleitetes Gerät, oder das System ist derzeit nicht mit dem durch den Parameter angegebenen Gerät verbunden. |
|
Es gibt geöffnete Dateien, und der fForce Parameter ist FALSE. |
Bemerkungen
Windows Server 2003 und Windows XP: Die WNet-Funktionen erstellen und löschen Netzwerklaufwerkbuchstaben im MS-DOS Gerätenamespace, der einer Anmeldesitzung zugeordnet ist, da MS-DOS Geräte durch AuthenticationID identifiziert werden. (Eine AuthenticationID ist die lokal eindeutigen Bezeichnersoder LUID, die einer Anmeldesitzung zugeordnet ist.) Dies kann sich auf Anwendungen auswirken, die eine der WNet-Funktionen aufrufen, um einen Netzlaufwerkbuchstaben unter einer Benutzeranmeldung zu erstellen, aber abfragen Sie vorhandene Netzlaufwerkbuchstaben unter einer anderen Benutzeranmeldung. Ein Beispiel für diese Situation könnte sein, wenn die zweite Anmeldung eines Benutzers innerhalb einer Anmeldesitzung erstellt wird, z. B. durch Aufrufen der CreateProcessAsUser--Funktion, und die zweite Anmeldung führt eine Anwendung aus, die die GetLogicalDrives-Funktion aufruft. GetLogicalDrives- gibt keine Netzwerklaufwerkbuchstaben zurück, die von einer WNet-Funktion unter der ersten Anmeldung erstellt wurden. Beachten Sie, dass im vorherigen Beispiel die erste Anmeldesitzung noch vorhanden ist und das Beispiel auf jede Anmeldesitzung angewendet werden kann, einschließlich einer Terminaldienste-Sitzung. Weitere Informationen finden Sie unter Definieren eines MS-DOS Gerätenamens.
Anmerkung
Der winnetwk.h-Header definiert WNetCancelConnection als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | winnetwk.h |
| Library | Mpr.lib |
| DLL- | Mpr.dll |
Siehe auch
übersicht über Windows Networking (WNet)