RIORESULT-Struktur (mswsockdef.h)
Die RIORESULT-Struktur enthält Daten, die verwendet werden, um Die Ergebnisse der Anforderungsabschluss anzugeben, die mit den registrierten Winsock-E/A-Erweiterungen verwendet werden.
Syntax
typedef struct _RIORESULT {
LONG Status;
ULONG BytesTransferred;
ULONGLONG SocketContext;
ULONGLONG RequestContext;
} RIORESULT, *PRIORESULT;
Member
Status
Der Abschluss status der winsock-registrierten E/A-Anforderung.
BytesTransferred
Die Anzahl der in der E/A-Anforderung gesendeten oder empfangenen Bytes.
SocketContext
Ein von der Anwendung bereitgestellter Kontext, der im Aufruf der RIOCreateRequestQueue-Funktion angegeben wird.
RequestContext
Ein von der Anwendung bereitgestellter Kontext, der mit der registrierten E/A-Anforderung für die Funktionen RIOReceive, RIOReceiveEx, RIOSend und RIOSendEx angegeben wird.
Hinweise
Die RIORESULT-Struktur definiert das Datenformat, das verwendet wird, um den Abschluss der Anforderung durch die registrierten Winsock-E/A-Erweiterungen anzugeben. Eine Anwendung fordert Vervollständigungsanzeigen an, indem ein Array von RIORESULT-Strukturen zugewiesen und das Array der RIORESULT-Strukturen zusammen mit der Elementanzahl an die RIODequeueCompletion-Funktion übergeben wird. Die Anwendung muss keine Initialisierung der RIORESULT-Strukturelemente durchführen, bevor die RIODequeueCompletion-Funktion aufgerufen wird.
Der SocketContext-Member der RIORESULT-Struktur kann von einer Anwendung verwendet werden, um das RIO_CQ-Objekt oder das zugeordnete Anwendungsobjekt zu identifizieren, für das die winsock-registrierte E/A-Anforderung ausgestellt wurde. Das RequestContext-Element der RIORESULT-Struktur kann auf ähnliche Weise verwendet werden, um die bestimmte winsock-registrierte E/A-Anforderung zu identifizieren, die abgeschlossen wurde.
Die RIORESULT-Struktur ist in der Headerdatei Mswsockdef.h definiert, die automatisch in der Headerdatei Mswsock.h enthalten ist. Die Headerdatei "Mswsockdef.h " sollte niemals direkt verwendet werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Kopfzeile | mswsockdef.h (mswsock.h einschließen) |