Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die WskRegister-Funktion registriert eine WSK-Anwendung, da der WSK-Client der Anwendung Network Programming Interface (NPI).
Syntax
NTSTATUS WskRegister(
[in] PWSK_CLIENT_NPI WskClientNpi,
[out] PWSK_REGISTRATION WskRegistration
);
Parameter
[in] WskClientNpi
Ein Zeiger auf den Client-NPI, der von der WSK-Anwendung implementiert wird.
[out] WskRegistration
Ein Zeiger auf einen Speicherspeicherort, der die Registrierungsinstanz einer WSK-Anwendung identifiziert. Dieser Speicherspeicherort wird vom WskRegister Aufruf initialisiert und wird von den anderen WSK-Registrierungsfunktionenverwendet. Die WSK-Anwendung sollte den Inhalt dieses Speicherspeicherorts niemals direkt ändern.
Rückgabewert
WskRegister- gibt einen der folgenden NTSTATUS-Codes zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Die Registrierung war erfolgreich. |
|
Fehler bei der Registrierung. |
Bemerkungen
Ein WSK-Clientobjekt kann diese Funktion mehrmals aufrufen, aber ein anderer WskRegistration Parameter muss für jeden Aufruf verwendet werden, um mehrere Registrierungsinstanzen zu erstellen.
Für jeden Aufruf von WskRegister, der einen Erfolgscode zurückgibt, muss genau ein entsprechender WskDeregister-aufruf vorhanden sein, der denselben WskRegistration Parameter verwendet, der an WskRegisterübergeben wurde.
Der Speicherblock, auf den WskRegistration verweist, muss zugeordnet bleiben (darf nicht freigegeben oder nicht im Gültigkeitsbereich liegen), solange es noch ausstehende Aufrufe an andere WSK-Registrierungsfunktionengibt.
Die Verwendung der funktionen WskRegister und WskDeregister ist die bevorzugte Methode zum Registrieren und Aufheben der Registrierung von WSK-Anwendungen. Die Netzwerkmodulregistrierungsstelle bleibt aus Gründen der Kompatibilität verfügbar.
Weitere Informationen zum Anfügen einer WSK-Anwendung an das WSK-Subsystem finden Sie unter Registrieren einer Winsock Kernel-Anwendung.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform- | Universal |
| Header- | wsk.h (include Wsk.h) |
| Library | Netio.lib |
| IRQL- | PASSIVE_LEVEL |