WPUQuerySocketHandleContext
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função consultará o valor contexto associado com o identificador especificado Soquete.
Syntax
int WPUQuerySocketHandleContext(
SOCKET s,
PDWORD_PTR lpContext,
LPINT lpErrno
);
Parameters
- s
[no] Descrição identifica o Soquete cujo contexto é para ser consultado.
- lpContext
[out] Ponteiro que receberá o valor contexto.
- lpErrno
[out] Ponteiro para o código de erro.
Return Value
Se nenhum erro ocorrer, essa função retorna zero e armazena o atual valor contexto no lpContext. Caso contrário, ele retorna SOCKET_ERROR e um código de erro específico está disponível em lpErrno.
A seguinte tabela mostra a código de erro possíveis.
| Valor de erro | Descrição |
|---|---|
WSAENOTSOCK |
O descritor não é um Soquete criado por WPUCreateSocketHandle. |
Remarks
Essa função consultará o atual contexto valor associado com o identificador especificado Soquete. Serviço provedores geralmente usar esta função para recuperar um ponteiro para dados Provider-specific associado com a Soquete. Para exemplo, um provedor serviço pode usar o contexto Soquete para armazenar um ponteiro para uma estrutura que contém estado do Soquete, local e remoto endereços transporte e objetos evento para sinalização eventos rede.
Esta função só é usada por provedores não-IFS porque IFS provedores não são capazes fornecer um valor contexto.
Requirements
| Header | ws2spi.h |
| Library | Ws2.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |