Estrutura RIORESULT (mswsockdef.h)

Artigo
08/25/2023

A estrutura RIORESULT contém dados usados para indicar os resultados de conclusão da solicitação usados com as extensões de E/S registradas do Winsock.

Sintaxe

typedef struct _RIORESULT {
  LONG      Status;
  ULONG     BytesTransferred;
  ULONGLONG SocketContext;
  ULONGLONG RequestContext;
} RIORESULT, *PRIORESULT;

Membros

Status

O status de conclusão da solicitação de E/S registrada do Winsock.

BytesTransferred

O número de bytes enviados ou recebidos na solicitação de E/S.

SocketContext

Um contexto fornecido pelo aplicativo especificado na chamada para a função RIOCreateRequestQueue .

RequestContext

Um contexto fornecido pelo aplicativo especificado com a solicitação de E/S registrada para as funções RIOReceive, RIOReceiveEx, RIOSend e RIOSendEx .

Comentários

A estrutura RIORESULT define o formato de dados usado para indicar a conclusão da solicitação pelas extensões de E/S registradas do Winsock. Um aplicativo solicita indicações de conclusão alocando uma matriz de estruturas RIORESULT e passando a matriz de estruturas RIORESULT para a função RIODequeueCompletion junto com a contagem de elementos. O aplicativo não precisa executar nenhuma inicialização dos elementos da estrutura RIORESULT antes de chamar a função RIODequeueCompletion .

O membro SocketContext da estrutura RIORESULT pode ser usado por um aplicativo para identificar o objeto RIO_CQ ou o objeto de aplicativo associado no qual a solicitação de E/S registrada winsock foi emitida. O membro RequestContext da estrutura RIORESULT pode ser usado da mesma forma para identificar a solicitação de E/S registrada do Winsock específica que foi concluída.

A estrutura RIORESULT é definida no arquivo de cabeçalho Mswsockdef.h , que é incluído automaticamente no arquivo de cabeçalho Mswsock.h . O arquivo de cabeçalho Mswsockdef.h nunca deve ser usado diretamente.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Cabeçalho	mswsockdef.h (inclua Mswsock.h)