WSPGetOverlappedResult

9/8/2008

Essa função retorna os resultados de uma operação sobreposta na Soquete especificado.

Syntax

BOOL WSPGetOverlappedResult(
  SOCKET s,
  LPWSAOVERLAPPED lpOverlapped,
  LPDWORD lpcbTransfer,
  BOOL fWait,
  LPDWORD lpdwFlags,
  LPINT lpErrno 
);

Parameters

• s
  [no] Identifica o Soquete. Este é o mesmo Soquete que foi especificado quando a operação sobreposta foi iniciada por um chamar para WSPRecv, WSPRecvFrom, WSPSend, WSPSendTo, ou WSPIoctl.

• lpOverlapped
  [no] Aponta para um WSAOVERLAPPED estrutura que foi especificada quando a operação sobreposta foi iniciada.

• lpcbTransfer
  [out] Aponta para um 32-bit variável que recebe o número de bytes que realmente foram transferidos por um envio ou operação de recebimento, ou por WSPIoctl.

• fWait
  [no] Especifica se a função deve esperar para a pendente sobreposto operação para completo. Se TRUE, a função NÃO retorna até que a operação seja concluída. FALSE e a operação se ainda estiver pendente, a função retorna FALSE e lpErrno é WSA_IO_INCOMPLETE. O fWait parâmetro pode ser configurado para TRUE somente se a operação sobreposta selecionado notificação de conclusão Event-Based.

• lpdwFlags
  [out] Aponta para um 32-bit variável que receberá um ou mais sinalizadores que complementam o status de conclusão. Se a operação sobreposta foi iniciada por WSPRecv Ou WSPRecvFrom, esse parâmetro irá conter o valor de resultados para lpFlags parâmetro.

• lpErrno
  [out] Ponteiro para o código de erro.

Return Value

Essa função sempre retornará SOCKET_ERROR e define lpErrno Para WSASYSCALLFAILURE em Windows Embedded CE.

Remarks

Os resultados relatados por essa função são aqueles última operação sobreposto do Soquete o especificado à qual o especificado WSAOVERLAPPED estrutura foi fornecida e para os quais foram os resultados da operação pendente. Um pendente operação é indicada quando a função que iniciou a operação retorna SOCKET_ERROR e o lpErrno é WSA_IO_PENDING. Quando uma operação E/S estiver pendente, a função que iniciou a operação redefine o hEvent membro das WSAOVERLAPPED estrutura para o não sinalizado estado. Então, quando o pendente operação foi concluída, o sistema define o objeto evento para o sinalizado estado.

Se a pasta fWait parâmetro for TRUE, essa função determina se o pendente operação foi concluída pelo bloqueio e aguardando objeto o evento no sinalizado estado. Um cliente pode definido o fWait parâmetro para TRUE somente se ele selecionado notificação de conclusão Event-Based quando a operação E/S foi solicitada. Se outra forma de notificação foi selecionada, o uso de hEvent membro das WSAOVERLAPPED estrutura é diferente e configuração fWait Para TRUE causar resultados imprevisíveis.

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

See Also

Reference

WSPRecv
WSPRecvFrom
WSPSend
WSPSendTo
WSPConnect
WSPAccept
WSPIoctl