WPUQuerySocketHandleContext 函式 (ws2spi.h)

  • 發行項

WPUQuerySocketHandleContext 函式會查詢與指定套接字句柄相關聯的內容值。

語法

int WPUQuerySocketHandleContext(
  [in]  SOCKET     s,
  [out] PDWORD_PTR lpContext,
  [out] LPINT      lpErrno
);

參數

[in] s

描述，識別要查詢其內容的套接字。

[out] lpContext

將接收內容值的指標。

[out] lpErrno

錯誤碼的指標。

傳回值

如果沒有發生錯誤， WPUQuerySocketHandleContext 會傳回零，並將目前的內容值儲存在 lpContext 中。 否則，它會傳回SOCKET_ERROR，而且 lpErrno 中提供特定的錯誤碼。

錯誤碼 意義
WSAENOTSOCK
 描述元不是 WPUCreateSocketHandle 所建立的套接字。
 
 

備註

WPUQuerySocketHandleContext 函式會查詢與指定套接字句柄相關聯的目前內容值。 服務提供者通常會使用此函式來擷取與套接字相關聯之提供者特定數據的指標。 例如，服務提供者可以使用套接字內容來儲存包含套接字狀態、本機和遠端傳輸地址的結構指標，以及用於發出網路事件訊號的事件物件。

只有非 IFS 提供者會使用此函式，因為 IFS 提供者無法提供內容值。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 ws2spi.h

另請參閱

WPUCreateSocketHandle