WskRegister-Funktion (wsk.h)

Die WskRegister-Funktion registriert eine WSK-Anwendung unter Berücksichtigung der WSK-Client-Netzwerkprogrammierschnittstelle (Network Programming Interface, NPI) der Anwendung.

Syntax

NTSTATUS WskRegister(
  [in]  PWSK_CLIENT_NPI   WskClientNpi,
  [out] PWSK_REGISTRATION WskRegistration
);

Parameter

[in] WskClientNpi

Ein Zeiger auf den clientseitigen NPI, der von der WSK-Anwendung implementiert wird.

[out] WskRegistration

Ein Zeiger auf einen Speicherspeicherort, der die Registrierung einer WSK-Anwendung instance identifiziert. Dieser Speicherspeicherort wird durch den WskRegister-Aufruf initialisiert und von den anderen WSK-Registrierungsfunktionen verwendet. Die WSK-Anwendung sollte den Inhalt dieses Speicherspeicherorts nie direkt ändern.

Rückgabewert

WskRegister gibt einen der folgenden NTSTATUS-Codes zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Registrierung war erfolgreich.
Andere status Codes	Fehler bei der Registrierung.

Hinweise

Ein WSK-Clientobjekt kann diese Funktion mehrmals aufrufen, aber für jeden Aufruf muss ein anderer WskRegistration-Parameter 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 den gleichen WskRegistration-Parameter verwendet, der an WskRegister übergeben wurde.

Der Speicherblock, auf den WskRegistration verweist, muss zugeordnet bleiben (darf nicht freigegeben werden oder aus dem Bereich entfernt werden), solange ausstehende Aufrufe anderer WSK-Registrierungsfunktionen vorhanden sind.

Die Verwendung der Funktionen WskRegister und WskDeregister ist die bevorzugte Methode zum Registrieren und Aufheben der Registrierung von WSK-Anwendungen. Die Netzwerkmodulregistrierung bleibt aus Kompatibilitätsgründen verfügbar.

Weitere Informationen zum Anfügen einer WSK-Anwendung an das WSK-Subsystem finden Sie unter Registrieren einer Winsock-Kernelanwendung.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Universell
Header	wsk.h (einschließen von Wsk.h)
Bibliothek	Netio.lib
IRQL	PASSIVE_LEVEL

Weitere Informationen

WSK_CLIENT_NPI

WSK_REGISTRATION

WskDeregister