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:
| Formato de retorno de chamada | Valor do tipo |
|---|---|
| Sondagem | NSP_NOTIFY_IMMEDIATELY |
| Mensagem de Janela | NSP_NOTIFY_HWND |
| Evento | NSP_NOTIFY_EVENT |
| APC | NSP_NOTIFY_APC |
| Porta de Conclusão | NSP_NOTIFY_PORT |
Para uma função de bloqueio, defina a estrutura WSACOMPLETION como nula.
Requisitos
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Cabeçalho | winsock2.h |