Table of Contents

QUIC_STATUS type

The status type MsQuic uses for all API return codes.

Syntax

Windows (User Mode)

#define QUIC_STATUS                     HRESULT
#define QUIC_FAILED(X)                  FAILED(X)
#define QUIC_SUCCEEDED(X)               SUCCEEDED(X)

Linux

#define QUIC_STATUS                     unsigned long
#define QUIC_FAILED(X)                  ((int)(X) > 0)
#define QUIC_SUCCEEDED(X)               ((int)(X) <= 0)

Remarks

The QUIC_STATUS type is a cross platform abstraction of the current platform's error code space. It allows for both success and failure values, which can be easily determined by the QUIC_SUCCEEDED and QUIC_FAILED macros.

The MsQuic headers define a number of different possible values for this (see below) but this list is not exhaustive. The platform specific functionality (for example UDP sockets) may also return platform specific error codes up to the app.

Well-Known Status Codes

Value Meaning
QUIC_STATUS_SUCCESS The operation completed successfully.
QUIC_STATUS_PENDING The operation is pending.
QUIC_STATUS_CONTINUE The operation will continue.
QUIC_STATUS_OUT_OF_MEMORY Allocation of memory failed.
QUIC_STATUS_INVALID_PARAMETER An invalid parameter was encountered.
QUIC_STATUS_INVALID_STATE The current state was not valid for this operation.
QUIC_STATUS_NOT_SUPPORTED The operation was not supported.
QUIC_STATUS_NOT_FOUND The object was not found.
QUIC_STATUS_BUFFER_TOO_SMALL The buffer was too small for the operation.
QUIC_STATUS_HANDSHAKE_FAILURE The connection handshake failed.
QUIC_STATUS_ABORTED The connection or stream was aborted.
QUIC_STATUS_ADDRESS_IN_USE The local address is already in use.
QUIC_STATUS_INVALID_ADDRESS Binding to socket failed, likely caused by a family mismatch between local and remote address.
QUIC_STATUS_CONNECTION_TIMEOUT The connection timed out waiting for a response from the peer.
QUIC_STATUS_CONNECTION_IDLE The connection timed out from inactivity.
QUIC_STATUS_INTERNAL_ERROR An internal error was encountered.
QUIC_STATUS_UNREACHABLE The server is currently unreachable.
QUIC_STATUS_CONNECTION_REFUSED The server refused the connection.
QUIC_STATUS_PROTOCOL_ERROR A protocol error was encountered.
QUIC_STATUS_VER_NEG_ERROR A version negotiation error was encountered.
QUIC_STATUS_USER_CANCELED The peer app/user canceled the connection during the handshake.
QUIC_STATUS_ALPN_NEG_FAILURE The connection handshake failed to negotiate a common ALPN.
QUIC_STATUS_STREAM_LIMIT_REACHED A stream failed to start because the peer doesn't allow any more to be open at this time.