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 |
|---|---|
|
Die Registrierung war erfolgreich. |
|
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 |