WSCUnInstallNameSpace32-Funktion (ws2spi.h)
Die WSCUnInstallNameSpace32-Funktion deinstalliert einen bestimmten 32-Bit-Namespaceanbieter.
Syntax
INT WSCUnInstallNameSpace32(
[in] LPGUID lpProviderId
);
Parameter
[in] lpProviderId
Ein Zeiger auf einen global eindeutigen Bezeichner (Globally Unique Identifier, GUID) für den zu deinstallierenden Namensraumanbieter.
Rückgabewert
Wenn kein Fehler auftritt, gibt WSCUnInstallNameSpace32NO_ERROR (null) zurück. Andernfalls wird SOCKET_ERROR zurückgegeben, wenn die Funktion fehlschlägt, und Sie müssen den entsprechenden Fehlercode mithilfe der WSAGetLastError-Funktion abrufen.
| Fehlercode | Bedeutung |
|---|---|
| Der parameter lpProviderId verweist auf arbeitsspeicher, der sich nicht in einem gültigen Teil des Benutzeradressraums befindet. | |
| Der angegebene Namespace-Anbieterbezeichner ist ungültig. | |
| Ein Systemaufruf, der nie fehlschlagen sollte, ist fehlgeschlagen. | |
| Es war nicht genügend Arbeitsspeicher verfügbar. Dieser Fehler wird zurückgegeben, wenn nicht genügend Arbeitsspeicher zum Zuordnen eines neuen Katalogeintrags vorhanden ist. |
Hinweise
WSCUnInstallNameSpace32 ist eine streng 32-Bit-Version von WSCUnInstallNameSpace. Auf einem 64-Bit-Computer werden alle Aufrufe, die nicht speziell 32-Bit-Versionen (z. B. alle Funktionen, die nicht auf "32" enden) im nativen 64-Bit-Katalog ausgeführt. Prozesse, die auf einem 64-Bit-Computer ausgeführt werden, müssen die spezifischen 32-Bit-Funktionsaufrufe verwenden, um mit einem strikten 32-Bit-Katalog zu arbeiten und die Kompatibilität aufrechtzuerhalten. Die Definitionen und Semantik der spezifischen 32-Bit-Aufrufe sind identisch mit ihren nativen Entsprechungen.
Die Namespacekonfigurationsfunktionen wirken sich nicht auf Anwendungen aus, die bereits ausgeführt werden. Neu installierte Namensraumanbieter sind weder für Anwendungen sichtbar, noch werden die Änderungen im Aktivierungsstatus eines Namensraumanbieters angezeigt. Anwendungen, die nach dem Aufruf von WSCUnInstallNameSpace32 gestartet wurden, erkennen die Änderungen.
Bei Erfolg versucht WSCUnInstallNameSpace32 , alle interessierten Anwendungen, die sich für die Benachrichtigung über die Änderung registriert haben, durch Aufrufen von WSAProviderConfigChange zu benachrichtigen.
Die WSCUnInstallNameSpace32-Funktion kann nur von einem Benutzer aufgerufen werden, der als Mitglied der Gruppe Administratoren angemeldet ist. Wenn WSCUnInstallNameSpace32 von einem Benutzer aufgerufen wird, der kein Mitglied der Gruppe Administratoren ist, schlägt der Funktionsaufruf fehl, und WSANO_RECOVERY wird im lpErrno-Parameter zurückgegeben.
Bei Computern unter Windows Vista oder Windows Server 2008 kann diese Funktion auch aufgrund der Benutzerkontensteuerung (UAC) fehlschlagen. Wenn eine Anwendung, die diese Funktion enthält, von einem Benutzer ausgeführt wird, der als Mitglied der Gruppe Administratoren angemeldet ist, die nicht der integrierten Administratorgruppe angehört, schlägt dieser Aufruf fehl, es sei denn, die Anwendung wurde in der Manifestdatei mit einem requestedExecutionLevel gekennzeichnet, der auf requireAdministrator festgelegt ist. Wenn in der Anwendung unter Windows Vista oder Windows Server 2008 diese Manifestdatei nicht vorhanden ist, muss ein Benutzer, der sich als Mitglied der Gruppe "Administratoren" angemeldet hat und nicht der integrierte Administrator die Anwendung in einer erweiterten Shell als integrierter Administrator (RunAs-Administrator) ausführen, damit diese Funktion erfolgreich ist.
Der Aufrufer dieser Funktion muss alle zusätzlichen Dateien oder Dienstanbieter-spezifischen Konfigurationsinformationen entfernen, die zum vollständigen Deinstallieren des Dienstanbieters erforderlich sind.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista, Windows XP Professional x64 Edition [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008, Windows Server 2003 x64 Edition [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | ws2spi.h |
| Bibliothek | Ws2_32.lib |
| DLL | Ws2_32.dll |