PFN_WSK_GET_ADDRESS_INFO Rückruffunktion (wsk.h)

Artikel
03/01/2024

Die WskGetAddressInfo-Funktion führt eine protokollunabhängige Übersetzung von einem Hostnamen in eine Transportadresse durch.

Syntax

PFN_WSK_GET_ADDRESS_INFO PfnWskGetAddressInfo;

NTSTATUS PfnWskGetAddressInfo(
  [in]           PWSK_CLIENT Client,
  [in, optional] PUNICODE_STRING NodeName,
  [in, optional] PUNICODE_STRING ServiceName,
  [in, optional] ULONG NameSpace,
  [in, optional] GUID *Provider,
  [in, optional] PADDRINFOEXW Hints,
  [out]          PADDRINFOEXW *Result,
  [in, optional] PEPROCESS OwningProcess,
  [in, optional] PETHREAD OwningThread,
  [in, out]      PIRP Irp
)
{...}

Parameter

[in] Client

[in] Ein Zeiger auf eine WSK_CLIENT-Struktur , die über den WskProviderNpi-Parameter des -Parameters zurückgegeben wurde WskCaptureProviderNPI-Funktion .

[in, optional] NodeName

[in] Ein optionaler Zeiger auf eine UNICODE_STRING-Struktur , die eine Unicode-Zeichenfolge enthält, die einen Hostnamen (Knoten) oder eine numerische Hostadressenzeichenfolge darstellt. Für das Internetprotokoll ist die numerische Hostadressenzeichenfolge eine gepunktete dezimale IPv4-Adresse oder eine IPv6-Hexadezimaladresse.

[in, optional] ServiceName

[in] Ein optionaler Zeiger auf eine UNICODE_STRING-Struktur , die eine Unicode-Zeichenfolge enthält, die einen Dienstnamen oder eine Portnummer darstellt.

[in, optional] NameSpace

[in] Ein optionaler Namespacebezeichner, der die abgefragten Namespaceanbieter angibt. Nur Namespaceanbieter, die den angegebenen Namespace unterstützen, können erfolgreich abgefragt werden.

[in, optional] Provider

[in] Ein optionaler Zeiger auf eine GUID eines bestimmten Namespaceanbieters, der abgefragt werden soll.

[in, optional] Hints

[in] Ein optionaler Zeiger auf eine ADDRINFOEXW-Struktur , die Hinweise zum Typ des Sockets bereitstellt, den der Aufrufer unterstützt.

Die ADDRINFOEXW-Struktur ist im Ws2def.h-Header definiert. Es ist identisch mit der
addrinfoex-Struktur .

Wichtig Die Ws2def.h-Headerdatei wird automatisch in Wsk.h eingeschlossen. Verwenden Sie Ws2def.h nicht direkt.

[out] Result

[out] Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der eine verknüpfte Liste einer oder mehrerer ADDRINFOEXW-Strukturen empfängt , die Antwortinformationen zum Host darstellen.

Hinweis Der Aufrufer muss die WskFreeAddressInfo-Funktion aufrufen, um diesen Zeiger frei zu geben.

Die ADDRINFOEXW-Struktur ist im Ws2def.h-Header definiert. Sie ist identisch mit der addrinfoex-Struktur .

Wichtig Die Ws2def.h-Headerdatei wird automatisch in Wsk.h eingeschlossen. Verwenden Sie Ws2def.h nicht direkt.

[in, optional] OwningProcess

[in] Ein optionaler Zeiger auf den Prozess, aus dem die Funktion den Sicherheitskontext abruft. Dieser Sicherheitskontext gibt den Benutzerkontokontext an, in dem die Funktion die Namensauflösungsanforderung verarbeitet.

Wenn dieser Parameter NULL ist, verarbeitet die Funktion die Namensauflösungsanforderung im Kontext eines vordefinierten lokalen Kontos mit minimalen Berechtigungen.

Wenn dieser Parameter nicht NULL ist und ein Identitätswechseltoken für den aufrufenden Thread wirksam ist, schlägt diese Funktion fehl und gibt STATUS_INVALID_PARAMETER zurück.

[in, optional] OwningThread

[in] Ein optionaler Zeiger auf den Thread, aus dem die Funktion den Sicherheitskontext abruft. Dieser Parameter kann nur nicht NULL sein, wenn OwningProcess nicht NULL ist. Andernfalls schlägt diese Funktion fehl und gibt STATUS_INVALID_PARAMETER zurück.

Wenn dieser Parameter nicht NULL ist und ein Identitätswechseltoken für den aufrufenden Thread wirksam ist, schlägt diese Funktion fehl und gibt STATUS_INVALID_PARAMETER zurück.

[in, out] Irp

[in/out] Ein Zeiger auf ein E/A-Anforderungspaket (IRP), das zum asynchronen Abschließen der Anforderung verwendet werden soll. Nach Abschluss der Anforderung enthält Irp ->Iostatus.Information den zurückgegebenen status Code.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_INVALID_PARAMETER	Ein ungültiger Parameter wurde angegeben.
STATUS_NO_MATCH	Der Hostname kann nicht aufgelöst werden.
STATUS_SUCCESS	Die Funktion wurde erfolgreich abgeschlossen. Wenn die WSK-Anwendung einen Zeiger auf eine IRP im Irp-Parameter, das IRP wird mit einer erfolgreichen status abgeschlossen.
STATUS_PENDING	Das WSK-Subsystem konnte die Funktion nicht sofort abschließen. Das WSK-Subsystem schließt das IRP ab, nachdem der Steuerungsvorgang abgeschlossen wurde. Die status des Steuerungsvorgangs wird im Feld IoStatus.Status des IRP zurückgegeben.
Andere status Codes	Ein Fehler ist aufgetreten. Die IRP wird mit einem Fehler status abgeschlossen.

Hinweise

Der Prozess, auf den der OwningProcess-Parameter verweist, oder der Thread, auf den der OwningThread-Prozess verweist, gibt den Sicherheitskontext für diese Funktion an. Das durch den Sicherheitskontext angegebene Benutzerkonto gibt den Kontext für die Namensauflösungsanforderung der Funktion an.

Anforderungen

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

Weitere Informationen

UNICODE_STRING

WSK_CLIENT

WskCaptureProviderNPI

WskFreeAddressInfo

Freigeben über