語法
參數
uniqueIdentifier uint16_t*輸出 輸出的唯一識別碼。
傳回值
PartyErrorc_partyErrorSuccess (如果呼叫成功),否則為錯誤碼。可透過 PartyManager::GetErrorMessage() 擷取錯誤碼的人類可讀形式。
備註
此識別碼在端點的網路中是唯一的,並且在網路中的所有端點之間保持一致。它的用途是作為精簡的選項,讓遊戲在 PartyLocalEndpoint::SendMessage() 資料緩衝區中參考特定端點,而不會造成太多頻寬額外負荷,也不需要手動交涉識別碼。此識別碼在不同網路之間並非唯一。對於本機端點,在 PartyManager::StartProcessingStateChanges() 提供 PartyEndpointCreatedStateChange 之前,此方法都會失敗。對於遠端端點,此方法一律會成功。
網路中的所有裝置對於指定端點的唯一識別碼都會一致,但不同的裝置在特定時間點不一定會看到相同的端點。例如,端點 A 可能會傳送訊息給端點 B,其中參考新建立之端點 C 的唯一識別碼,但 A 與 B 之間的該訊息可能會在端點 B 的裝置上產生端點 C 的 PartyEndpointCreatedStateChange 之前送達。
需求
標頭: Party.h另請參閱
PartyEndpointPartyEndpointCreatedStateChange
PartyNetwork::FindEndpointByUniqueIdentifier
