Estrutura WSACOMPLETION (winsock2.h)

A estrutura WSACOMPLETION especifica as configurações de notificação de conclusão para chamadas de controle de E/S feitas a um namespace registrado.

Sintaxe

typedef struct _WSACOMPLETION {
  WSACOMPLETIONTYPE Type;
  union {
    struct {
      HWND   hWnd;
      UINT   uMsg;
      WPARAM context;
    } WindowMessage;
    struct {
      LPWSAOVERLAPPED lpOverlapped;
    } Event;
    struct {
      LPWSAOVERLAPPED                    lpOverlapped;
      LPWSAOVERLAPPED_COMPLETION_ROUTINE lpfnCompletionProc;
    } Apc;
    struct {
      LPWSAOVERLAPPED lpOverlapped;
      HANDLE          hPort;
      ULONG_PTR       Key;
    } Port;
  } Parameters;
} WSACOMPLETION, *PWSACOMPLETION, *LPWSACOMPLETION;

Membros

Type

Tipo: WSACOMPLETIONTYPE

O tipo de notificação de conclusão necessária. Consulte Observações.

Parameters

Os parâmetros necessários para concluir o retorno de chamada. As estruturas dentro da união Parâmetros especificam as informações necessárias para concluir o retorno de chamada de cada tipo especificado. Por exemplo, a estrutura WindowMessage deve ser preenchida quando Type é definido como NSP_NOTIFY_HWND.

Parameters.WindowMessage

Parameters.WindowMessage.hWnd

Tipo: HWND Identificador do Windows.

Parameters.WindowMessage.uMsg

Tipo: UINT Identificador de mensagem.

Parameters.WindowMessage.context

Tipo: WPARAM Contexto da mensagem ou do identificador.

Parameters.Event

Parameters.Event.lpOverlapped

Tipo: LPWSAOVERLAPPED Um ponteiro para uma estrutura WSAOVERLAPPED .

Parameters.Apc

Parameters.Apc.lpOverlapped

Tipo: LPWSAOVERLAPPED Um ponteiro para uma estrutura WSAOVERLAPPED .

Parameters.Apc.lpfnCompletionProc

Tipo: _In_opt_ LPWSAOVERLAPPED_COMPLETION_ROUTINE

Um ponteiro para uma rotina de conclusão fornecida pelo aplicativo.

Parameters.Port

Parameters.Port.lpOverlapped

Tipo: LPWSAOVERLAPPED Um ponteiro para uma estrutura WSAOVERLAPPED .

Parameters.Port.hPort

Tipo: HANDLE Um identificador para a porta.

Parameters.Port.Key

Tipo: ULONG_PTR Um ponteiro para a chave.

Comentários

A estrutura WSACOMPLETION permite que os retornos de chamada sejam fornecidos em qualquer um dos seguintes formatos, com base no valor fornecido em Tipo:

Para uma função de bloqueio, defina a estrutura WSACOMPLETION como nula.

Requisitos

Confira também

WSANSPIoctl