語法
參數
handle PFMultiplayerHandle
PFMultiplayer API 執行個體的控制代碼。
server PFEntityKey*
伺服器實體。
configuration PFMatchmakingServerBackfillTicketConfiguration*
回填票證設定。
asyncContext void*選用 選用的應用程式定義指標大小內容值，可用來將完成狀態變更與此呼叫建立關聯。
ticket PFMatchmakingTicketHandle*程式庫配置的輸出 產生的票證物件。
傳回值
類型：HRESULT 如果呼叫成功，則為S_OK；否則為錯誤碼。可透過 PFMultiplayerGetErrorMessage() 擷取錯誤碼的人類可讀形式。
備註
若要使用此功能，您必須在包含 PFMatchmaking.h 之前定義 PFMULTIPLAYER_INCLUDE_SERVER_APIS。程式庫會自動以非同步方式將伺服器回填票證提交至配對服務。每次票證狀態變更時，都會提供 PFMatchmakingTicketStatusChangedStateChange。可隨時透過 PFMatchmakingTicketGetStatus() 查詢票證狀態。票證會立即以
PFMatchmakingTicketStatus::Creating 狀態開始。 票證完成時，會提供 PFMatchmakingTicketStatusChangedStateChange。此時，已找到回填票證的比賽或票證因失敗而停止。成功時，可透過 PFMatchmakingTicketGetMatch() 查詢找到的比賽。PFMatchmakingMatchDetails 中的
regionPreferences 只包含伺服器所在的區域。 如果票證建立因設定中指定的使用者已有太多票證而失敗，程式庫會以透明方式取消那些未完成的票證，然後重試建立票證。
此函式要求先前已呼叫 PFMultiplayerSetEntityToken() 來設定遊戲伺服器實體權杖。