共用方式為

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

[in]透過的 WskProviderNpi 參數傳回之WSK_CLIENT結構的指標 WskCaptureProviderNPI 函式。

[in, optional] NodeName

[in]UNICODE_STRING 結構的選擇性 指標，其中包含代表主機 (節點) 名稱或數值主機位址字串的 Unicode 字串。 針對因特網通訊協議，數值主機位址字串是虛線十進位IPv4位址或IPv6 十六進位位址。

[in, optional] ServiceName

[in] UNICODE_STRING 結構的選擇性指標，其中包含代表服務名稱或埠號碼的 Unicode 字串。

[in, optional] NameSpace

[in]選擇性命名空間識別碼，指定查詢的命名空間提供者。 只有支援指定命名空間的命名空間提供者才能成功查詢。

[in, optional] Provider

[in]要查詢之特定命名空間提供者之 GUID 的選擇性指標。

[in, optional] Hints

[in] ADDRINFOEXW 結構的選擇性指標，提供呼叫端所支援套接字類型的提示。

ADDRINFOEXW 結構定義於 Ws2def.h 標頭中。 它與相同
addrinfoex 結構。

重要 Ws2def.h 頭文件會自動包含在 Wsk.h 中。 請勿直接使用 Ws2def.h。
 

[out] Result

[out]呼叫端配置的緩衝區指標，可接收一或多個 ADDRINFOEXW 結構的連結清單，代表主機的響應資訊。

注意 呼叫端必須呼叫 WskFreeAddressInfo 函式以釋放此指標。
 
ADDRINFOEXW 結構定義於 Ws2def.h 標頭中。 它與 addrinfoex 結構相同。
重要 Ws2def.h 頭文件會自動包含在 Wsk.h 中。 請勿直接使用 Ws2def.h。
 

[in, optional] OwningProcess

[in]函式從中擷取安全性內容之進程的選擇性指標。 此安全性內容表示函式處理名稱解析要求的用戶帳戶內容。

如果此參數為 NULL，函式會在預先定義的本機帳戶內容中處理名稱解析要求，且具有最低許可權。

如果此參數不是 NULL ，而且模擬令牌對呼叫線程有效，則此函式會失敗並傳回STATUS_INVALID_PARAMETER。

[in, optional] OwningThread

[in]函式從中擷取安全性內容的線程選擇性指標。 只有當 OwningProcess 不是 NULL 時，此參數才可以是非 NULL。 否則，此函式會失敗並傳回STATUS_INVALID_PARAMETER。

如果此參數不是 NULL ，而且模擬令牌對呼叫線程有效，則此函式會失敗並傳回STATUS_INVALID_PARAMETER。

[in, out] Irp

[in/out]I/O 要求封包的指標 (IRP) ，以異步方式完成要求。 完成要求之後， Irp ->Iostatus.Information 會保留傳回的狀態代碼。

傳回值

WskGetAddressInfo 會傳回下列其中一個 NTSTATUS 代碼：

傳回碼 Description
STATUS_INVALID_PARAMETER
 指定了無效的參數。
STATUS_NO_MATCH
 無法解析主機名。
STATUS_SUCCESS
 語言函式已順利完成。 如果 WSK 應用程式在 中指定 IRP 的指標 Irp 參數會以成功狀態完成 IRP。
STATUS_PENDING
 WSK 子系統無法立即完成函式。 WSK 子系統會在完成控制作業之後完成 IRP。 控制作業的狀態將會在 IRP 的 [IoStatus.Status ] 字段中傳回。
其他狀態代碼
 發生錯誤。 IRP 將會以失敗狀態完成。

備註

OwningProcess 參數指向的進程，或 OwningThread 進程指向的線程，表示此函式的安全性內容。 安全性內容所表示的用戶帳戶表示函式名稱解析要求的內容。

規格需求

需求 值
最低支援的用戶端 可在 Windows 7 和更新版本的 Windows 作業系統中使用。
目標平台 Universal
標頭 wsk.h (包含 Wsk.h)
IRQL PASSIVE_LEVEL

另請參閱

UNICODE_STRING

WSK_CLIENT

WskCaptureProviderNPI

WskFreeAddressInfo