PFN_WSK_GET_ADDRESS_INFO コールバック関数 (wsk.h)

WskGetAddressInfo 関数は、ホスト名からトランスポート アドレスへのプロトコルに依存しない変換を実行します。

構文

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
)
{...}

パラメーター

[in] Client

[入力]の WskProviderNpi パラメーターを介して返されたWSK_CLIENT構造体へのポインター WskCaptureProviderNPI 関数。

[in, optional] NodeName

[入力]ホスト (ノード) 名または数値ホスト アドレス文字列を表す Unicode 文字列を含む UNICODE_STRING 構造体への省略可能なポインター。 インターネット プロトコルの場合、数値ホスト アドレス文字列はドット 10 進数の IPv4 アドレスまたは IPv6 16 進数アドレスです。

[in, optional] ServiceName

[入力]サービス名またはポート番号を表す Unicode 文字列を含む UNICODE_STRING 構造体への省略可能なポインター。

[in, optional] NameSpace

[入力]クエリを実行する名前空間プロバイダーを指定する省略可能な名前空間識別子。 指定した名前空間をサポートする名前空間プロバイダーのみが正常に照会できます。

[in, optional] Provider

[入力]クエリを実行する特定の名前空間プロバイダーの GUID への省略可能なポインター。

[in, optional] Hints

[入力]呼び出し元がサポートするソケットの種類に関するヒントを提供する ADDRINFOEXW 構造体への省略可能なポインター。

ADDRINFOEXW 構造体は、Ws2def.h ヘッダーで定義されています。 これは、 と同じです。
addrinfoex 構造体。

[out] Result

[out]ホストに関する応答情報を表す 1 つ以上の ADDRINFOEXW 構造体のリンクされたリストを受け取る呼び出し元割り当てバッファーへのポインター。

[in, optional] OwningProcess

[入力]関数がセキュリティ コンテキストを取得するプロセスへの省略可能なポインター。 このセキュリティ コンテキストは、関数が名前解決要求を処理するユーザー アカウント コンテキストを示します。

このパラメーターが NULL の場合、関数は最小限の特権で定義済みのローカル アカウントのコンテキストで名前解決要求を処理します。

このパラメーターが NULL ではなく、呼び出し元スレッドに対して偽装トークンが有効な場合、この関数は失敗し、STATUS_INVALID_PARAMETERを返します。

[in, optional] OwningThread

[入力]関数がセキュリティ コンテキストを取得するスレッドへの省略可能なポインター。 このパラメーターは、OwningProcess が NULL 以外の場合にのみ NULL 以外にすることができます。 それ以外の場合、この関数は失敗し、STATUS_INVALID_PARAMETERを返します。

このパラメーターが NULL ではなく、呼び出し元スレッドに対して偽装トークンが有効な場合、この関数は失敗し、STATUS_INVALID_PARAMETERを返します。

[in, out] Irp

[入力/出力]要求を非同期的に完了するために使用する I/O 要求パケット (IRP) へのポインター。 要求が完了すると、 Irp ->Iostatus.Information は返された状態コードを保持します。

戻り値

WskGetAddressInfo は 、次のいずれかの NTSTATUS コードを返します。

注釈

OwningProcess パラメーターが指すプロセス、または OwningThread プロセスが指すスレッドは、この関数のセキュリティ コンテキストを示します。 セキュリティ コンテキストによって示されるユーザー アカウントは、関数の名前解決要求のコンテキストを示します。

要件

こちらもご覧ください

UNICODE_STRING

WSK_CLIENT

WskCaptureProviderNPI

WskFreeAddressInfo