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

# XtfGetCredentialUserName

> XtfGetCredentialUserName

# XtfGetCredentialUserName

取得儲存在 [XtfGetCredentialInfoList](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetcredentialinfolist-xtfapi-xbox-windows-m.md) 所傳回之 XtfNetworkCredentials 物件中某個索引處的認證使用者名稱部分。

## 語法

```cpp theme={null}
HRESULT XtfGetCredentialUserName(
         XtfNetworkCredentials credentialInfo,
         UINT32 credentialIndex,
         PWSTR userName,
         UINT32 *userNameLength
)  
```

### 參數

*credentialInfo*\
類型：XtfNetworkCredentials

\[in] 呼叫 [XtfGetCredentialInfoList](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetcredentialinfolist-xtfapi-xbox-windows-m.md) 所建立的 XtfNetworkCredentials 物件。

*credentialIndex*\
類型：UINT32

\[in] **userName** 在 **credentialInfo** 物件中的索引。

*userName*\
類型：PWSTR

\[out] **credentialInfo** 物件中指定索引處的使用者名稱。

*userNameLength*\
類型：UINT32 \*

\[in, out] **userName** 緩衝區的長度 (以 WCHAR 為單位)。

### 傳回值

類型：HRESULT

如果成功，則傳回 **S\_OK**。如果 **userName** 不夠大，則傳回 HRESULT\_FROM\_WIN32(ERROR\_MORE\_DATA)。所需的緩衝區長度會在 **userNameLength** 中傳回。

## 備註

使用 [XtfAddCredential](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfaddcredential-xtfapi-xbox-windows-m.md) 新增認證。使用 [XtfRemoveCredential](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfremovecredential-xtfapi-xbox-windows-m.md) 移除認證。使用 [XtfGetCredentialInfoList](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetcredentialinfolist-xtfapi-xbox-windows-m.md)、[XtfGetCredentialInfoCount](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetcredentialinfocount-xtfapi-xbox-windows-m.md)、[XtfGetCredentialServerName](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetcredentialtargetname-xtfapi-xbox-windows-m.md) 和 [XtfGetCredentialUserName](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetcredentialusername-xtfapi-xbox-windows-m.md) 列舉目前儲存的認證清單。使用 [XtfCloseCredentialInfoList](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfclosecredentialinfo-xtfapi-xbox-windows-m.md) 釋放 [XtfGetCredentialInfoList](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetcredentialinfolist-xtfapi-xbox-windows-m.md) 所傳回的 XtfNetworkCredentials。

如需如何使用此 API 的範例，請參閱 [XtfGetCredentialInfoList](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetcredentialinfolist-xtfapi-xbox-windows-m.md)。

## 需求

**標頭：** xtfapi.h

**程式庫：** XtfApi.lib

**支援的平台：** Windows (適用於 XBOX 主機工具)

## 另請參閱

[從 PC 執行部署 (NDA 主題)](https://docs.xbox.com/zh-TW/home/setup-install/concepts/deployment.md)\
[XTF 傳輸錯誤 (NDA 主題)](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/xtf-transport-errors.md)\
[其他 Xtf API](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/atoc-xtfapi.md)


## Related topics

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