> ## 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.

# XtfGetCredentialServerName

> XtfGetCredentialServerName

# XtfGetCredentialServerName

获取由 [XtfGetCredentialInfoList](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/functions/xtfgetcredentialinfolist-xtfapi-xbox-windows-m.md) 返回的 XtfNetworkCredentials 对象中指定索引处凭据的服务器名部分。

## 语法

```cpp theme={null}
HRESULT XtfGetCredentialServerName(
         XtfNetworkCredentials credentialInfo,
         UINT32 credentialIndex,
         PWSTR serverName,
         UINT32 *serverNameSize
)  
```

### 参数

*credentialInfo*\
类型：XtfNetworkCredentials

\[in] 通过调用 [XtfGetCredentialInfoList](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/functions/xtfgetcredentialinfolist-xtfapi-xbox-windows-m.md) 创建的 XtfNetworkCredentials 对象。

*credentialIndex*\
类型：UINT32

\[in] **credentialInfo** 对象中 serverName 的索引。

*serverName*\
类型：PWSTR

\[out] **credentialInfo** 对象中给定索引处的服务器名。

*serverNameSize*\
类型：UINT32 \*

\[in, out] serverName 缓冲区的长度（以 WCHAR 为单位）。

### 返回值

类型：HRESULT

成功时返回 **S\_OK**。如果 **serverName** 空间不够，则返回 `HRESULT_FROM_WIN32(ERROR_MORE_DATA)`。所需的缓冲区长度在 **serverNameLength** 中返回。

## 备注

使用 [XtfAddCredential](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/functions/xtfaddcredential-xtfapi-xbox-windows-m.md) 添加凭据。使用 [XtfRemoveCredential](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/functions/xtfremovecredential-xtfapi-xbox-windows-m.md) 移除凭据。使用 [XtfGetCredentialInfoList](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/functions/xtfgetcredentialinfolist-xtfapi-xbox-windows-m.md)、[XtfGetCredentialInfoCount](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/functions/xtfgetcredentialinfocount-xtfapi-xbox-windows-m.md)、[XtfGetCredentialServerName](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/functions/xtfgetcredentialtargetname-xtfapi-xbox-windows-m.md) 和 [XtfGetCredentialUserName](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/functions/xtfgetcredentialusername-xtfapi-xbox-windows-m.md) 来枚举当前存储的凭据列表。使用 [XtfCloseCredentialInfoList](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/functions/xtfclosecredentialinfo-xtfapi-xbox-windows-m.md) 释放由 [XtfGetCredentialInfoList](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/functions/xtfgetcredentialinfolist-xtfapi-xbox-windows-m.md) 返回的 XtfNetworkCredentials。

有关如何使用此 API 的示例，请参阅 [XtfGetCredentialInfoList](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/functions/xtfgetcredentialinfolist-xtfapi-xbox-windows-m.md)。

## 要求

**头文件：** xtfapi.h

**库：** XtfApi.lib

**支持的平台：** Windows（用于 XBOX 主机工具）

## 另请参阅

[Run from PC Deployment (NDA 主题)](https://docs.xbox.com/zh-CN/home/setup-install/concepts/deployment.md)\
[XTF 传输错误 (NDA 主题)](https://docs.xbox.com/zh-CN/tools/tools-console/commandlinetools/xtf-transport-errors.md)\
[其他 Xtf API](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/atoc-xtfapi.md)


## Related topics

- [XtfGetCredentialInfoList](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/functions/xtfgetcredentialinfolist-xtfapi-xbox-windows-m.md)
- [XtfGetCredentialUserName](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/functions/xtfgetcredentialusername-xtfapi-xbox-windows-m.md)
- [XtfAddCredential](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/functions/xtfaddcredential-xtfapi-xbox-windows-m.md)
- [XtfRemoveCredential](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/functions/xtfremovecredential-xtfapi-xbox-windows-m.md)
- [XtfCloseCredentialInfoList](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/functions/xtfclosecredentialinfo-xtfapi-xbox-windows-m.md)