Estrutura WSAOVERLAPPED (winsock2.h)

Artigo
03/04/2024

A estrutura WSAOVERLAPPED fornece um meio de comunicação entre o início de uma operação de E/S sobreposta e sua conclusão subsequente. A estrutura WSAOVERLAPPED é compatível com a estrutura OVERLAPPED do Windows.

Sintaxe

typedef struct _WSAOVERLAPPED {
  DWORD    Internal;
  DWORD    InternalHigh;
  DWORD    Offset;
  DWORD    OffsetHigh;
  WSAEVENT hEvent;
} WSAOVERLAPPED, *LPWSAOVERLAPPED;

Membros

Internal

Tipo: ULONG_PTR

Reservado para uso interno. O membro Interno é usado internamente pela entidade que implementa E/S sobreposta. Para provedores de serviços que criam soquetes como identificadores do SISTEMA de Arquivos Instalável (IFS), esse parâmetro é usado pelo sistema operacional subjacente. Outros provedores de serviços (provedores não IFS) são livres para usar esse parâmetro conforme necessário.

InternalHigh

Tipo: ULONG_PTR

Reservado. Usado internamente pela entidade que implementa E/S sobreposta. Para provedores de serviços que criam soquetes como identificadores IFS, esse parâmetro é usado pelo sistema operacional subjacente. Os provedores nãoIFS são livres para usar esse parâmetro conforme necessário.

Offset

Tipo: DWORD

Reservado para uso por provedores de serviços.

OffsetHigh

Tipo: DWORD

Reservado para uso por provedores de serviços.

hEvent

Tipo: HANDLE

Se uma operação de E/S sobreposta for emitida sem uma rotina de conclusão de E/S (o parâmetro lpCompletionRoutine da operação for definido como nulo), esse parâmetro deverá conter um identificador válido para um objeto WSAEVENT ou ser nulo. Se o parâmetro lpCompletionRoutine da chamada for não nulo, os aplicativos estarão livres para usar esse parâmetro conforme necessário.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	winsock2.h