PFMatchmakingTicketSetCustomContext

Configures an optional, custom pointer-sized context value with this ticket object.

Syntax

HRESULT PFMatchmakingTicketSetCustomContext(  
    PFMatchmakingTicketHandle ticket,  
    void* customContext  
)  

Parameters

ticket   PFMatchmakingTicketHandle

The handle of the matchmaking ticket.

customContext   void*
optional

An arbitrary, pointer-sized value to store with the player object.

Return value

Type: HRESULT

S_OK if configuring the custom context succeeded or an error code otherwise. The human-readable form of the error code can be retrieved via PFMultiplayerGetErrorMessage().

Remarks

The custom context is typically used as a "shortcut" that simplifies accessing local, title-specific memory associated with the matchmaking ticket without requiring a mapping lookup. The value is retrieved using the PFMatchmakingTicketGetCustomContext() method.

Any configured value is treated as opaque by the library, and is only valid on the local device; it is not transmitted over the network.

Requirements

Header: PFMatchmaking.h

See also

PFMatchmaking members
PFMatchmakingTicketGetCustomContext