> ## 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](/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](/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

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