Freigeben über


PFMatchmakingTicketSetCustomContext

Konfiguriert einen optionalen, benutzerdefinierten Kontextwert in Zeigergröße mit diesem Ticketobjekt.

Syntax

HRESULT PFMatchmakingTicketSetCustomContext(  
    PFMatchmakingTicketHandle ticket,  
    void* customContext  
)  

Parameter

ticket PFMatchmakingTicketHandle

Das Handle des Matchmaking-Tickets.

customContext Leere*
Optional

Ein beliebiger Wert in Zeigergröße, der mit dem Playerobjekt gespeichert werden soll.

Rückgabewert

Typ: HRESULT

S_OK , wenn die Konfiguration des benutzerdefinierten Kontexts erfolgreich war oder andernfalls ein Fehlercode vorhanden ist. Die lesbare Form des Fehlercodes kann über PFMultiplayerGetErrorMessage() abgerufen werden.

Hinweise

Der benutzerdefinierte Kontext wird in der Regel als "Verknüpfung" verwendet, die den Zugriff auf den lokalen, titelspezifischen Speicher vereinfacht, der dem Matchmaking-Ticket zugeordnet ist, ohne dass eine Zuordnungssuche erforderlich ist. Der Wert wird mithilfe der PFMatchmakingTicketGetCustomContext()- Methode abgerufen.

Jeder konfigurierte Wert wird von der Bibliothek als nicht transparent behandelt und ist nur auf dem lokalen Gerät gültig. sie wird nicht über das Netzwerk übertragen.

Voraussetzungen

Header: PFMatchmaking.h

Weitere Informationen

PFMatchmaking-Mitglieder
PFMatchmakingTicketGetCustomContext