Condividi tramite

Struttura WSACOMPLETION (winsock2.h)

  • Articolo

La struttura WSACOMPLETION specifica le impostazioni di notifica di completamento per le chiamate di controllo I/O effettuate a uno spazio dei nomi registrato.

Sintassi

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;

Members

Type

Tipo: WSACOMPLETIONTYPE

Tipo di notifica di completamento necessaria. Vedere la sezione Osservazioni.

Parameters

Parametri necessari per completare il callback. Le strutture all'interno dell'unione Parametri specificano le informazioni necessarie per completare il callback di ogni tipo specificato. Ad esempio, la struttura WindowMessage deve essere riempita quando Type è impostato su NSP_NOTIFY_HWND.

Parameters.WindowMessage

Parameters.WindowMessage.hWnd

Tipo: HWND Handle di Windows.

Parameters.WindowMessage.uMsg

Tipo: UINT Handle dei messaggi.

Parameters.WindowMessage.context

Tipo: WPARAM Contesto del messaggio o dell'handle.

Parameters.Event

Parameters.Event.lpOverlapped

Tipo: LPWSAOVERLAPPED Puntatore a una struttura WSAOVERLAPPED .

Parameters.Apc

Parameters.Apc.lpOverlapped

Tipo: LPWSAOVERLAPPED Puntatore a una struttura WSAOVERLAPPED .

Parameters.Apc.lpfnCompletionProc

Tipo: _In_opt_ LPWSAOVERLAPPED_COMPLETION_ROUTINE

Puntatore a una routine di completamento fornita dall'applicazione.

Parameters.Port

Parameters.Port.lpOverlapped

Tipo: LPWSAOVERLAPPED Puntatore a una struttura WSAOVERLAPPED .

Parameters.Port.hPort

Tipo: HANDLE Handle alla porta.

Parameters.Port.Key

Tipo: ULONG_PTR Puntatore alla chiave.

Commenti

La struttura WSACOMPLETION consente di fornire i callback in uno dei formati seguenti, in base al valore fornito in Tipo:

Formato di callback Valore del tipo
Polling NSP_NOTIFY_IMMEDIATELY
Messaggio finestra NSP_NOTIFY_HWND
Evento NSP_NOTIFY_EVENT
APC NSP_NOTIFY_APC
Porta di completamento NSP_NOTIFY_PORT
 

Per una funzione di blocco, impostare la struttura WSACOMPLETION su Null.

Requisiti

   
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione winsock2.h

Vedi anche

WSANSPIoctl