WSAOVERLAPPED-Struktur (winsock2.h)

Artikel
03/04/2024

Die WSAOVERLAPPED-Struktur stellt ein Kommunikationsmedium zwischen der Einleitung eines überlappenden E/A-Vorgangs und dessen anschließender Fertigstellung bereit. Die WSAOVERLAPPED-Struktur ist mit der Windows OVERLAPPED-Struktur kompatibel.

Syntax

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

Member

Internal

Typ: ULONG_PTR

Für die interne Verwendung reserviert. Der interne Member wird intern von der Entität verwendet, die überlappende E/A implementiert. Für Dienstanbieter, die Sockets als installierbare Dateisystemhandles (IFS) erstellen, wird dieser Parameter vom zugrunde liegenden Betriebssystem verwendet. Andere Dienstanbieter (Nicht-IFS-Anbieter) können diesen Parameter bei Bedarf verwenden.

InternalHigh

Typ: ULONG_PTR

Reserviert. Wird intern von der Entität verwendet, die überlappende E/A implementiert. Für Dienstanbieter, die Sockets als IFS-Handles erstellen, wird dieser Parameter vom zugrunde liegenden Betriebssystem verwendet. NonIFS-Anbieter können diesen Parameter bei Bedarf verwenden.

Offset

Art: DWORD

Reserviert für die Verwendung durch Dienstanbieter.

OffsetHigh

Art: DWORD

Reserviert für die Verwendung durch Dienstanbieter.

hEvent

Typ: HANDLE

Wenn ein überlappender E/A-Vorgang ohne E/A-Vervollständigungsroutine ausgegeben wird (der lpCompletionRoutine-Parameter des Vorgangs ist auf NULL festgelegt), sollte dieser Parameter entweder ein gültiges Handle für ein WSAEVENT-Objekt enthalten oder NULL sein. Wenn der lpCompletionRoutine-Parameter des Aufrufs ungleich NULL ist, können Anwendungen diesen Parameter bei Bedarf verwenden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	winsock2.h