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

Obtém a parte do nome do servidor 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 XtfGetCredentialServerName(
         XtfNetworkCredentials credentialInfo,
         UINT32 credentialIndex,
         PWSTR serverName,
         UINT32 *serverNameSize
)  
```

### 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 serverName no objeto **credentialInfo**.

*serverName*\
Tipo: PWSTR

\[out] Nome do servidor no índice fornecido no objeto **credentialInfo**.

*serverNameSize*\
Tipo: UINT32 \*

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

### Valor retornado

Tipo: HRESULT

Retorna **S\_OK** se for bem-sucedido. Retorna `HRESULT_FROM_WIN32(ERROR_MORE_DATA)` se **serverName** não for grande o suficiente. O comprimento de buffer necessário é retornado em **serverNameLength**.

## 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)
- [XtfGetCredentialUserName](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgetcredentialusername-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)