Structure WSAOVERLAPPED (winsock2.h)

Article
03/13/2024

La structure WSAOVERLAPPED fournit un moyen de communication entre l’initiation d’une opération d’E/S qui se chevauche et son achèvement ultérieur. La structure WSAOVERLAPPED est compatible avec la structure Windows OVERLAPPED .

Syntaxe

typedef struct _WSAOVERLAPPED {
  DWORD    Internal;
  DWORD    InternalHigh;
  DWORD    Offset;
  DWORD    OffsetHigh;
  WSAEVENT hEvent;
} WSAOVERLAPPED, *LPWSAOVERLAPPED;

Membres

Internal

Type : ULONG_PTR

Réservé à un usage interne. Le membre interne est utilisé en interne par l’entité qui implémente les E/S qui se chevauchent. Pour les fournisseurs de services qui créent des sockets en tant que handles IFS (Installable File System), ce paramètre est utilisé par le système d’exploitation sous-jacent. D’autres fournisseurs de services (fournisseurs non-IFS) sont libres d’utiliser ce paramètre si nécessaire.

InternalHigh

Type : ULONG_PTR

Réservé. Utilisé en interne par l’entité qui implémente les E/S qui se chevauchent. Pour les fournisseurs de services qui créent des sockets en tant que handles IFS, ce paramètre est utilisé par le système d’exploitation sous-jacent. Les fournisseurs nonIFS sont libres d’utiliser ce paramètre si nécessaire.

Offset

Type : DWORD

Réservé à l’utilisation par les fournisseurs de services.

OffsetHigh

Type : DWORD

Réservé à l’utilisation par les fournisseurs de services.

hEvent

Type : HANDLE

Si une opération d’E/S qui se chevauche est émise sans routine d’achèvement d’E/S (le paramètre lpCompletionRoutine de l’opération est défini sur null), ce paramètre doit contenir un handle valide pour un objet WSAEVENT ou avoir la valeur Null. Si le paramètre lpCompletionRoutine de l’appel n’est pas null, les applications sont libres d’utiliser ce paramètre si nécessaire.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	winsock2.h