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

Obtém a parte do nome de usuário das credenciais armazenadas em um índice de um objeto XtfNetworkCredentials retornado por [XtfGetCredentialInfoList](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgetcredentialinfolist-xtfapi-xbox-windows-m.md).

## Sintaxe

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

### Parâmetros

*credentialInfo*\
Tipo: XtfNetworkCredentials

\[in] Um objeto XtfNetworkCredentials criado chamando [XtfGetCredentialInfoList](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgetcredentialinfolist-xtfapi-xbox-windows-m.md).

*credentialIndex*\
Tipo: UINT32

\[in] Índice do **userName** no objeto **credentialInfo**.

*userName*\
Tipo: PWSTR

\[out] Nome de usuário no índice fornecido no objeto **credentialInfo**.

*userNameLength*\
Tipo: UINT32 \*

\[in, out] Comprimento do buffer **userName** em WCHAR.

### Valor retornado

Tipo: HRESULT

Retorna **S\_OK** se for bem-sucedido. Retorna HRESULT\_FROM\_WIN32(ERROR\_MORE\_DATA) se **userName** não for grande o suficiente. O comprimento de buffer necessário é retornado em **userNameLength**.

## Comentários

Use [XtfAddCredential](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfaddcredential-xtfapi-xbox-windows-m.md) para adicionar credenciais. Use [XtfRemoveCredential](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfremovecredential-xtfapi-xbox-windows-m.md) para remover credenciais. Use [XtfGetCredentialInfoList](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgetcredentialinfolist-xtfapi-xbox-windows-m.md), [XtfGetCredentialInfoCount](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgetcredentialinfocount-xtfapi-xbox-windows-m.md), [XtfGetCredentialServerName](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgetcredentialtargetname-xtfapi-xbox-windows-m.md) e [XtfGetCredentialUserName](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgetcredentialusername-xtfapi-xbox-windows-m.md) para enumerar a lista atual de credenciais armazenadas. Use [XtfCloseCredentialInfoList](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfclosecredentialinfo-xtfapi-xbox-windows-m.md) para liberar o XtfNetworkCredentials retornado por [XtfGetCredentialInfoList](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgetcredentialinfolist-xtfapi-xbox-windows-m.md).

Confira [XtfGetCredentialInfoList](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgetcredentialinfolist-xtfapi-xbox-windows-m.md) para obter um exemplo de como usar essa API.

## Requisitos

**Cabeçalho:** xtfapi.h

**Biblioteca:** XtfApi.lib

**Plataformas com suporte:** Windows (para ferramentas de console XBOX)

## Confira também

[Implantação de execução a partir do PC (tópico sob NDA)](https://docs.xbox.com/pt-BR/home/setup-install/concepts/deployment.md)\
[Erros de transporte do XTF (tópico sob NDA)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xtf-transport-errors.md)\
[APIs adicionais do Xtf](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/atoc-xtfapi.md)


## Related topics

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