WSCEnableNSProvider32-Funktion (ws2spi.h)
Die WSCEnableNSProvider32-Funktion aktiviert oder deaktiviert einen angegebenen 32-Bit-Namespaceanbieter. Es soll dem Endbenutzer die Möglichkeit geben, den Status der Namespaceanbieter zu ändern.
Syntax
INT WSCEnableNSProvider32(
[in] LPGUID lpProviderId,
[in] BOOL fEnable
);
Parameter
[in] lpProviderId
Ein Zeiger auf einen Globally Unique Identifier (GUID) für den Namespaceanbieter.
[in] fEnable
Ein boolescher Wert, der bei TRUE der Namespaceanbieter auf den aktiven Zustand festgelegt ist. Bei FALSE ist der Namespaceanbieter deaktiviert und steht nicht für Abfragevorgänge oder Dienstregistrierungen zur Verfügung.
Rückgabewert
Wenn kein Fehler auftritt, gibt die WSCEnableNSProvider32-FunktionNO_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 Namespaceanbieterbezeichner ist ungültig. | |
| Ein Systemaufruf, der niemals fehlschlagen sollte, ist fehlgeschlagen. | |
| Nicht genügend Arbeitsspeicher war verfügbar. Dieser Fehler wird zurückgegeben, wenn nicht genügend Arbeitsspeicher vorhanden ist, um einen neuen Katalogeintrag zuzuweisen. |
Hinweise
Die WSCEnableNSProvider32-Funktion soll verwendet werden, um den Status der Namespaceanbieter zu ändern. Ein unabhängiger Softwareanbieter (Independent Software Vendor, ISV) sollte normalerweise die Aktivierung des Namespaceanbieters eines anderen ISV nicht aufheben, um seinen eigenen zu aktivieren. Die Wahl sollte dem Benutzer überlassen werden.
WSCEnableNSProvider32 ist eine 32-Bit-Version von WSCEnableNSProvider. Auf einem 64-Bit-Computer werden alle Aufrufe, die nicht speziell 32-Bit-Aufrufe (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 Gegenstücken.
Die Namespacekonfigurationsfunktionen wirken sich nicht auf Anwendungen aus, die bereits ausgeführt werden. Neu installierte Namespaceanbieter sind weder für Anwendungen sichtbar, noch werden die Änderungen im Aktivierungsstatus eines Namespaceanbieters angezeigt. Bei Anwendungen, die nach dem Aufruf von WSCEnableNSProvider32 gestartet wurden, werden die Änderungen angezeigt.
Die WSCEnableNSProvider32-Funktion kann nur von einem Benutzer aufgerufen werden, der als Mitglied der Gruppe Administratoren angemeldet ist. Wenn WSCEnableNSProvider32 von einem Benutzer aufgerufen wird, der kein Mitglied der Gruppe Administratoren ist, schlägt der Funktionsaufruf fehl.
Bei Computern, die unter Windows Vista oder Windows Server 2008 ausgeführt werden, kann diese Funktion auch aufgrund der Benutzerkontensteuerung (UAC) fehlschlagen. Wenn eine Anwendung, die diese Funktion enthält, von einem Benutzer ausgeführt wird, der nicht als mitglied der Gruppe Administratoren als der integrierte Administrator angemeldet ist, schlägt dieser Aufruf fehl, es sei denn, die Anwendung wurde in der Manifestdatei mit einem requestedExecutionLevel-Wert gekennzeichnet, der auf requireAdministrator festgelegt ist. Wenn in der Anwendung unter Windows Vista oder Windows Server 2008 diese Manifestdatei fehlt, muss ein Benutzer, der sich als Mitglied der Gruppe Administratoren angemeldet hat, nicht der integrierte Administrator, die Anwendung dann in einer erweiterten Shell als integrierter Administrator (RunAs-Administrator) ausführen, damit diese Funktion erfolgreich ist.
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 |