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

# XblMultiplayerSessionSetServerConnectionStringCandidates

> XblMultiplayerSessionSetServerConnectionStringCandidates

# XblMultiplayerSessionSetServerConnectionStringCandidates

工作階段可用來連線至遊戲伺服器的已排序、不區分大小寫的連接字串清單。一般而言，遊戲應使用清單中的第一個，但較複雜的遊戲可以使用自訂機制來選擇其他的連接字串 (例如根據負載)。

## 語法

```cpp theme={null}
HRESULT XblMultiplayerSessionSetServerConnectionStringCandidates(  
         XblMultiplayerSessionHandle handle,  
         const char** serverConnectionStringCandidates,  
         size_t serverConnectionStringCandidatesCount  
)  
```

### 參數

*handle*   \_In\_\
類型：[XblMultiplayerSessionHandle](/zh-TW/reference/live/xsapi-c/multiplayer_c/handles/xblmultiplayersessionhandle)

多人遊戲工作階段的控制代碼。

*serverConnectionStringCandidates*   \_In\_reads\_(serverConnectionStringCandidatesCount)\
類型：char\*\*

連線路徑的集合。

*serverConnectionStringCandidatesCount*   \_In\_\
類型：size\_t

候選陣列的大小。

### 傳回值

類型：HRESULT

此 API 作業的 HRESULT 傳回碼。

## 需求

**標頭：** multiplayer\_c.h

**程式庫：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另請參閱

[multiplayer\_c](/zh-TW/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [XblMultiplayerSessionSetMatchmakingServerConnectionPath](/zh-TW/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionsetmatchmakingserverconnectionpath.md)
- [XblMultiplayerManagerLobbySessionSetLocalMemberConnectionAddress](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetlocalmemberconnectionaddress.md)
- [XblMultiplayerSessionSetRawServersJson](/zh-TW/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionsetrawserversjson.md)
- [XblMultiplayerSessionProperties](/zh-TW/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionproperties.md)
- [XblMultiplayerSessionHostCandidates](/zh-TW/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionhostcandidates.md)