WPUQuerySocketHandleContext 함수(ws2spi.h)

WPUQuerySocketHandleContext 함수는 지정된 소켓 핸들과 연결된 컨텍스트 값을 쿼리합니다.

구문

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

매개 변수

[in] s

컨텍스트를 쿼리할 소켓을 식별하는 설명입니다.

[out] lpContext

컨텍스트 값을 받을 포인터입니다.

[out] lpErrno

오류 코드에 대한 포인터입니다.

반환 값

오류가 발생하지 않으면 WPUQuerySocketHandleContext 는 0을 반환하고 현재 컨텍스트 값을 lpContext에 저장합니다. 그렇지 않으면 SOCKET_ERROR 반환되고 lpErrno에서 특정 오류 코드를 사용할 수 있습니다.

오류 코드	의미
WSAENOTSOCK	설명자는 WPUCreateSocketHandle에서 만든 소켓이 아닙니다.

 

 

설명

WPUQuerySocketHandleContext 함수는 지정된 소켓 핸들과 연결된 현재 컨텍스트 값을 쿼리합니다. 서비스 공급자는 일반적으로 이 함수를 사용하여 소켓과 연결된 공급자별 데이터에 대한 포인터를 검색합니다. 예를 들어 서비스 공급자는 소켓 컨텍스트를 사용하여 소켓의 상태, 로컬 및 원격 전송 주소 및 네트워크 이벤트 신호를 위한 이벤트 개체를 포함하는 구조체에 대한 포인터를 저장할 수 있습니다.

IFS 공급자는 컨텍스트 값을 제공할 수 없으므로 비 IFS 공급자만 이 함수를 사용합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	ws2spi.h

추가 정보

WPUCreateSocketHandle