Compartir a través de

Estructura WSACOMPLETION (winsock2.h)

  • Artículo

La estructura WSACOMPLETION especifica la configuración de notificación de finalización para las llamadas de control de E/S realizadas a un espacio de nombres registrado.

Sintaxis

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;

Miembros

Type

Tipo: WSACOMPLETIONTYPE

Tipo de notificación de finalización necesaria. Vea la sección Comentarios.

Parameters

Parámetros necesarios para completar la devolución de llamada. Las estructuras de la unión Parameters especifican la información necesaria para completar la devolución de llamada de cada tipo determinado. Por ejemplo, la estructura WindowMessage debe rellenarse cuando Type está establecido en NSP_NOTIFY_HWND.

Parameters.WindowMessage

Parameters.WindowMessage.hWnd

Tipo: HWND Identificador de Windows.

Parameters.WindowMessage.uMsg

Tipo: UINT Identificador de mensaje.

Parameters.WindowMessage.context

Tipo: WPARAM Contexto del mensaje o identificador.

Parameters.Event

Parameters.Event.lpOverlapped

Tipo: LPWSAOVERLAPPED Puntero a una estructura WSAOVERLAPPED .

Parameters.Apc

Parameters.Apc.lpOverlapped

Tipo: LPWSAOVERLAPPED Puntero a una estructura WSAOVERLAPPED .

Parameters.Apc.lpfnCompletionProc

Tipo: _In_opt_ LPWSAOVERLAPPED_COMPLETION_ROUTINE

Puntero a una rutina de finalización proporcionada por la aplicación.

Parameters.Port

Parameters.Port.lpOverlapped

Tipo: LPWSAOVERLAPPED Puntero a una estructura WSAOVERLAPPED .

Parameters.Port.hPort

Tipo: HANDLE Identificador del puerto.

Parameters.Port.Key

Tipo: ULONG_PTR Puntero a la clave.

Comentarios

La estructura WSACOMPLETION permite proporcionar devoluciones de llamada en cualquiera de los siguientes formatos, en función del valor proporcionado en Tipo:

Formato de devolución de llamada Valor del tipo
Sondeo NSP_NOTIFY_IMMEDIATELY
Mensaje de ventana NSP_NOTIFY_HWND
Evento NSP_NOTIFY_EVENT
APC NSP_NOTIFY_APC
Puerto de finalización NSP_NOTIFY_PORT
 

Para una función de bloqueo, establezca la estructura WSACOMPLETION en null.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado winsock2.h

Consulte también

WSANSPIoctl