> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PartyEndpoint::GetUniqueIdentifier

> 取得此端點在網路中的唯一識別碼。

取得此端點在網路中的唯一識別碼。

## 語法

```cpp theme={null}
PartyError GetUniqueIdentifier(  
    uint16_t* uniqueIdentifier  
)  
```

### 參數

**`uniqueIdentifier`**   uint16\_t\*\
*輸出*

輸出的唯一識別碼。

### 傳回值

PartyError

`c_partyErrorSuccess` (如果呼叫成功)，否則為錯誤碼。可透過 [PartyManager::GetErrorMessage()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md) 擷取錯誤碼的人類可讀形式。

## 備註

此識別碼在端點的網路中是唯一的，並且在網路中的所有端點之間保持一致。它的用途是作為精簡的選項，讓遊戲在 [PartyLocalEndpoint::SendMessage()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalEndpoint/methods/partylocalendpoint_sendmessage.md) 資料緩衝區中參考特定端點，而不會造成太多頻寬額外負荷，也不需要手動交涉識別碼。此識別碼在不同網路之間並非唯一。 \
\
 對於本機端點，在 [PartyManager::StartProcessingStateChanges()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_startprocessingstatechanges.md) 提供 [PartyEndpointCreatedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partyendpointcreatedstatechange.md) 之前，此方法都會失敗。對於遠端端點，此方法一律會成功。   \
\
 網路中的所有裝置對於指定端點的唯一識別碼都會一致，但不同的裝置在特定時間點不一定會看到相同的端點。例如，端點 A 可能會傳送訊息給端點 B，其中參考新建立之端點 C 的唯一識別碼，但 A 與 B 之間的該訊息可能會在端點 B 的裝置上產生端點 C 的 PartyEndpointCreatedStateChange 之前送達。

## 需求

**標頭：** Party.h

## 另請參閱

[PartyEndpoint](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyEndpoint/partyendpoint.md)\
[PartyEndpointCreatedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partyendpointcreatedstatechange.md)\
[PartyNetwork::FindEndpointByUniqueIdentifier](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_findendpointbyuniqueidentifier.md)


## Related topics

- [PartyNetwork::FindEndpointByUniqueIdentifier](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_findendpointbyuniqueidentifier.md)
- [PartyNetwork::CreateEndpoint](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_createendpoint.md)
- [PartyEndpoint::GetLocal](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyEndpoint/methods/partyendpoint_getlocal.md)
- [PartyEndpoint::GetNetwork](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyEndpoint/methods/partyendpoint_getnetwork.md)
- [PartyEndpoint::GetDevice](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyEndpoint/methods/partyendpoint_getdevice.md)