Share via

Structure WSACOMPLETION (winsock2.h)

  • Article

La structure WSACOMPLETION spécifie les paramètres de notification d’achèvement pour les appels de contrôle d’E/S effectués à un espace de noms inscrit.

Syntaxe

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;

Membres

Type

Type : WSACOMPLETIONTYPE

Type de notification d’achèvement requis. Consultez la section Notes.

Parameters

Paramètres requis pour terminer le rappel. Les structures au sein de l’union paramètres spécifient les informations requises pour terminer le rappel de chaque type donné. Par exemple, la structure WindowMessage doit être remplie lorsque Type est défini sur NSP_NOTIFY_HWND.

Parameters.WindowMessage

Parameters.WindowMessage.hWnd

Type : HWND Handle Windows.

Parameters.WindowMessage.uMsg

Type : UINT Handle de message.

Parameters.WindowMessage.context

Type : WPARAM Contexte du message ou du handle.

Parameters.Event

Parameters.Event.lpOverlapped

Type : LPWSAOVERLAPPED Pointeur vers une structure WSAOVERLAPPED .

Parameters.Apc

Parameters.Apc.lpOverlapped

Type : LPWSAOVERLAPPED Pointeur vers une structure WSAOVERLAPPED .

Parameters.Apc.lpfnCompletionProc

Type : _In_opt_ LPWSAOVERLAPPED_COMPLETION_ROUTINE

Pointeur vers une routine d’achèvement fournie par l’application.

Parameters.Port

Parameters.Port.lpOverlapped

Type : LPWSAOVERLAPPED Pointeur vers une structure WSAOVERLAPPED .

Parameters.Port.hPort

Type : HANDLE Handle du port.

Parameters.Port.Key

Type : ULONG_PTR Pointeur vers la clé.

Remarques

La structure WSACOMPLETION permet de fournir des rappels dans l’un des formats suivants, en fonction de la valeur fournie dans Type :

Format du rappel Valeur de type
Interrogation NSP_NOTIFY_IMMEDIATELY
Message de fenêtre NSP_NOTIFY_HWND
Événement NSP_NOTIFY_EVENT
APC NSP_NOTIFY_APC
Port d’achèvement NSP_NOTIFY_PORT
 

Pour une fonction bloquante, définissez la structure WSACOMPLETION sur null.

Configuration requise

   
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
En-tête winsock2.h

Voir aussi

WSANSPIoctl