WSCInstallNameSpace32-Funktion (ws2spi.h)
Die WSCInstallNameSpace32-Funktion installiert einen angegebenen 32-Bit-Namespaceanbieter. Für Anbieter, die mehrere Namespaces unterstützen können, muss diese Funktion für jeden unterstützten Namespace aufgerufen werden, und jedes Mal muss ein eindeutiger Anbieterbezeichner angegeben werden.
Syntax
INT WSCInstallNameSpace32(
[in] LPWSTR lpszIdentifier,
[in] LPWSTR lpszPathName,
[in] DWORD dwNameSpace,
[in] DWORD dwVersion,
[in] LPGUID lpProviderId
);
Parameter
[in] lpszIdentifier
Ein Zeiger auf eine Zeichenfolge, der den Anbieter identifiziert, der dem globalen eindeutigen Bezeichner (GUID) zugeordnet ist, der im lpProviderId-Parameter übergeben wird.
[in] lpszPathName
Ein Zeiger auf eine Zeichenfolge, die den Pfad zum DLL-Image des Anbieters enthält. Die Zeichenfolge beachtet die üblichen Regeln für die Pfadauflösung: Dieser Pfad kann eingebettete Umgebungszeichenfolgen (z. B. %SystemRoot) enthalten. Solche Umgebungszeichenfolgen werden immer dann erweitert, wenn die WS2_32.DLL die Anbieter-DLL anschließend im Namen einer Anwendung laden muss. Nachdem eingebettete Umgebungszeichenfolgen erweitert wurden, übergibt der Ws2_32.dll die resultierende Zeichenfolge an die LoadLibrary-Funktion , um den Anbieter in den Arbeitsspeicher zu laden. Weitere Informationen finden Sie unter LoadLibrary.
[in] dwNameSpace
Ein Deskriptor, der den von diesem Anbieter unterstützten Namespace angibt.
[in] dwVersion
Ein Deskriptor, der die Versionsnummer des Anbieters angibt.
[in] lpProviderId
Ein eindeutiger Bezeichner für diesen Anbieter. Diese GUID sollte von Uuidgen.exe generiert werden.
Rückgabewert
Wenn kein Fehler auftritt, gibt die WSCInstallNameSpace32-Funktion NO_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 |
|---|---|
| Die aufrufende Routine verfügt nicht über ausreichende Berechtigungen, um einen Namespace zu installieren. | |
| Mindestens ein Argument ist ungültig. | |
| Ein nicht behebbarer Fehler ist aufgetreten. Dieser Fehler wird unter verschiedenen Bedingungen zurückgegeben, einschließlich der folgenden: Der Anbieter ist bereits installiert, dem Benutzer fehlen die Administratorrechte, die zum Schreiben in die Winsock-Registrierung erforderlich sind, oder beim Erstellen oder Installieren eines Katalogeintrags ist ein Fehler aufgetreten. | |
| 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
WSCInstallNameSpace32 ist eine streng 32-Bit-Version von WSCInstallNameSpace. 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. Anwendungen, die nach dem Aufruf von WSCInstallNameSpace32 gestartet wurden, erkennen die Änderungen.
Die WSCInstallNameSpace32-Funktion kann nur von einem Benutzer aufgerufen werden, der als Mitglied der Gruppe Administratoren angemeldet ist. Wenn WSCInstallNameSpace32 von einem Benutzer aufgerufen wird, der kein Mitglied der Gruppe Administratoren ist, schlägt der Funktionsaufruf fehl. Bei Computern, auf denen Windows Vista oder Windows Server 2008 ausgeführt wird, 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
| Anforderung | Wert |
|---|---|
| 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 |