WPUQuerySocketHandleContext (Windows Embedded CE 6.0)

1/6/2010

This function queries the context value associated with the specified socket handle.

Syntax

int WPUQuerySocketHandleContext(
  SOCKET s,
  PDWORD_PTR lpContext,
  LPINT lpErrno 
);

Parameters

• s
  [in] Description identifying the socket whose context is to be queried.

• lpContext
  [out] Pointer that will receive the context value.

• lpErrno
  [out] Pointer to the error code.

Return Value

If no error occurs, this function returns zero and stores the current context value in lpContext. Otherwise, it returns SOCKET_ERROR, and a specific error code is available in lpErrno.

The following table shows the possible error code.

Remarks

This function queries the current context value associated with the specified socket handle. Service providers typically use this function to retrieve a pointer to provider-specific data associated with the socket. For example, a service provider can use the socket context to store a pointer to a structure containing the socket's state, local and remote transport addresses, and event objects for signaling network events.

This function is only used by non-IFS providers because IFS providers are not able to supply a context value.

Requirements

See Also

Reference

Winsock SPI Functions
WPUCreateSocketHandle