> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XtfGetAumid

> XtfGetAumid

# XtfGetAumid

Obtém a ID do modelo de usuário do aplicativo (AUMID) no índice especificado de um objeto de informações do pacote.

## Sintaxe

```cpp theme={null}
HRESULT XtfGetAumid(
         XtfPackageInfo packageInfo,
         UINT32 aumidIndex,
         PWSTR aumid,
         UINT32 *aumidBufferLength
)  
```

### Parâmetros

*packageInfo*\
Tipo: XtfPackageInfo

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

*aumidIndex*\
Tipo: UINT32

\[in] Índice da AUMID no pacote.

*aumid*\
Tipo: PWSTR

\[out, optional] A AUMID do pacote no índice especificado em `aumidIndex`.

*aumidBufferLength*\
Tipo: UINT32 \*

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

### Valor de retorno

Tipo: HRESULT

Retorna `S_OK` se tiver êxito. Se `aumid` não for grande o suficiente, esta função retornará `HRESULT_FROM_WIN32(ERROR_MORE_DATA)` e o comprimento de buffer necessário será retornado em `aumidBufferLength`.

## Comentários

Use esta função para obter a AUMID no índice especificado em `aumidIndex` 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](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfregisterpackage-xtfapi-xbox-windows-m) ou [XtfRegisterNetworkSharePackage](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfregisternetworksharepackage-xtfapi-xbox-windows-m) para registrar um pacote.

Antes de chamar esta função, use a função [XtfGetcountofAppUserModelIds](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgetcountofappusermodelids-xtfapi-xbox-windows-m) para obter a contagem de AUMIDs do pacote. Se você especificar em `aumidIndex` um valor igual ou maior que o valor retornado por `XtfGetcountofAppUserModelIds`, ocorrerá um erro. Da mesma forma, ocorrerá um erro se não houver dados a serem recuperados no índice especificado em `aumidIndex`.

Você também pode usar a função [XtfGetPackageFullName](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgetpackagefullname-xtfapi-xbox-windows-m) para recuperar o nome completo de um pacote registrado. Para obter mais informações sobre pacotes, confira [Empacotamento](/pt-BR/build/core-features/common/packaging/gc-packaging-toc).

## 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)](/pt-BR/tools/tools-console/commandlinetools/xtf-transport-errors)\
[XtfRegisterPackage](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfregisterpackage-xtfapi-xbox-windows-m)\
[XtfRegisterNetworkSharePackage](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfregisternetworksharepackage-xtfapi-xbox-windows-m)\
[APIs adicionais do Xtf](/pt-BR/reference/tools/xtf/xtfapi/atoc-xtfapi)


## Related topics

- [XtfGetTitleOSState](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgettitleosstate-xtfapi-xbox-windows-m.md)
- [XtfGetTitleOSFourPartVersion](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgettitleosfourpartversion-xtfapi-xbox-windows-m.md)
- [XtfGetCountofAppUserModelIds](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgetcountofappusermodelids-xtfapi-xbox-windows-m.md)
- [XtfGetPackageFullName](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgetpackagefullname-xtfapi-xbox-windows-m.md)
- [XtfRegisterPackageOnDrive](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfregisterpackageondrive-xtfapi-xbox-windows-m.md)