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

# XtfGetPackageFullName

> XtfGetPackageFullName

# XtfGetPackageFullName

Obtém o nome completo do pacote de um objeto de informações do pacote.

## Sintaxe

```cpp theme={null}
HRESULT XtfGetPackageFullName(
         XtfPackageInfo packageInfo,
         PWSTR packageFullName,
         UINT32 *packageFullNameBufferLength
)  
```

### Parâmetros

*packageInfo*\
Tipo: XtfPackageInfo

\[in] Um ponteiro para o objeto de informações de um pacote.

*packageFullName*\
Tipo: PWSTR

\[out, optional] O nome completo do pacote.

*packageFullNameBufferLength*\
Tipo: UINT32 \*

\[in, out] O comprimento, em `WCHAR`, alocado para `packageFullName`.

### Valor retornado

Tipo: HRESULT

Retorna `S_OK` se for bem-sucedido. Se `packageFullName` não for grande o suficiente, essa função retornará `HRESULT_FROM_WIN32(ERROR_MORE_DATA)` e o comprimento de buffer necessário será retornado em `packageFullNameBufferLength`.

## Comentários

Use essa função para obter o nome completo do pacote do objeto de informações de um pacote registrado. Um ponteiro para um objeto de informações do pacote é retornado ao chamar a função [XtfRegisterPackage](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfregisterpackage-xtfapi-xbox-windows-m.md) ou [XtfRegisterNetworkSharePackage](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfregisternetworksharepackage-xtfapi-xbox-windows-m.md) para registrar um pacote.

Você também pode usar as funções [XtfGetCountofAppUserModelIds](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgetcountofappusermodelids-xtfapi-xbox-windows-m.md) e [XtfGetAumid](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgetaumid-xtfapi-xbox-windows-m.md) para recuperar as AUMIDs (Application User Model IDs) de um pacote registrado. Para obter mais informações sobre pacotes, confira [Empacotamento](https://docs.xbox.com/pt-BR/build/core-features/common/packaging/gc-packaging-toc.md).

O nome completo do pacote é usado nas operações de gerenciamento do tempo de vida da plataforma encontradas na interface [IXtfApplicationClient](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t.md).

## Requisitos

**Cabeçalho:** xtfapi.h

**Biblioteca:** XtfApi.lib

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

## Confira também

[Erros de transporte do XTF (tópico sob NDA)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xtf-transport-errors.md)\
[XtfRegisterPackage](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfregisterpackage-xtfapi-xbox-windows-m.md)\
[XtfRegisterNetworkSharePackage](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfregisternetworksharepackage-xtfapi-xbox-windows-m.md)\
[APIs adicionais do Xtf](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/atoc-xtfapi.md)


## Related topics

- [XtfGetTitleOSState](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgettitleosstate-xtfapi-xbox-windows-m.md)
- [XtfRegisterNetworkSharePackage](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfregisternetworksharepackage-xtfapi-xbox-windows-m.md)
- [XtfGetTitleOSFourPartVersion](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgettitleosfourpartversion-xtfapi-xbox-windows-m.md)
- [XtfRegisterPackage](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfregisterpackage-xtfapi-xbox-windows-m.md)
- [XtfRegisterPackageOnDrive](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfregisterpackageondrive-xtfapi-xbox-windows-m.md)