Pular para o conteúdo principal

XtfGetCredentialUserName

Obtém a parte do nome de usuário das credenciais armazenadas em um índice de um objeto XtfNetworkCredentials retornado por XtfGetCredentialInfoList.

Sintaxe

Parâmetros

credentialInfo
Tipo: XtfNetworkCredentials
[in] Um objeto XtfNetworkCredentials criado chamando XtfGetCredentialInfoList. 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 para adicionar credenciais. Use XtfRemoveCredential para remover credenciais. Use XtfGetCredentialInfoList, XtfGetCredentialInfoCount, XtfGetCredentialServerName e XtfGetCredentialUserName para enumerar a lista atual de credenciais armazenadas. Use XtfCloseCredentialInfoList para liberar o XtfNetworkCredentials retornado por XtfGetCredentialInfoList. Confira XtfGetCredentialInfoList 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)
Erros de transporte do XTF (tópico sob NDA)
APIs adicionais do Xtf
Última modificação em 6 de outubro de 2026