PFN_WSK_GET_ADDRESS_INFO Rückruffunktion (wsk.h)
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 .
[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.
[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 |
|---|---|
|
Ein ungültiger Parameter wurde angegeben. |
|
Der Hostname kann nicht aufgelöst werden. |
|
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. |
|
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. |
|
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 |