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

Obtiene el identificador de modelo de usuario de aplicación (AUMID) en el índice especificado a partir de un objeto de información de paquete.

<a id="syntaxSection" />

## Sintaxis

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

<a id="parametersSection" />

### Parámetros

*packageInfo*\
Tipo: XtfPackageInfo

\[in] El puntero al objeto de información de un paquete.

*aumidIndex*\
Tipo: UINT32

\[in] Índice del AUMID en el paquete.

*aumid*\
Tipo: PWSTR

\[out, optional] El AUMID en el índice especificado en `aumidIndex` para el paquete.

*aumidBufferLength*\
Tipo: UINT32 \*

\[in, out] La longitud, en **WCHAR**, asignada para `aumid`.

<a id="retvalSection" />

### Valor devuelto

Tipo: HRESULT

Devuelve `S_OK` si se realiza correctamente. Si `aumid` no es lo suficientemente grande, esta función devuelve `HRESULT_FROM_WIN32(ERROR_MORE_DATA)` y la longitud de búfer necesaria se devuelve en `aumidBufferLength`.

<a id="remarksSection" />

## Comentarios

Use esta función para obtener el AUMID en el índice especificado en `aumidIndex` a partir del objeto de información de un paquete registrado. Se devuelve un puntero a un objeto de información de paquete al llamar a la función [XtfRegisterPackage](/reference/tools/xtf/xtfapi/functions/xtfregisterpackage-xtfapi-xbox-windows-m) o [XtfRegisterNetworkSharePackage](/reference/tools/xtf/xtfapi/functions/xtfregisternetworksharepackage-xtfapi-xbox-windows-m) para registrar un paquete.

Antes de llamar a esta función, use la función [XtfGetcountofAppUserModelIds](/reference/tools/xtf/xtfapi/functions/xtfgetcountofappusermodelids-xtfapi-xbox-windows-m) para obtener el recuento de AUMID del paquete. Si especifica un valor en `aumidIndex` igual o mayor que el valor devuelto por `XtfGetcountofAppUserModelIds`, se produce un error. De forma similar, se produce un error si no hay datos que recuperar en el índice especificado en `aumidIndex`.

También puede usar la función [XtfGetPackageFullName](/reference/tools/xtf/xtfapi/functions/xtfgetpackagefullname-xtfapi-xbox-windows-m) para recuperar el nombre completo de un paquete registrado. Para obtener más información sobre los paquetes, consulte [Empaquetado](/build/core-features/common/packaging/gc-packaging-toc).

<a id="requirements" />

## Requisitos

**Encabezado:** xtfapi.h

**Biblioteca:** XtfApi.lib

**Plataformas compatibles:** Windows (para herramientas de consola XBOX)

<a id="seealsoSection" />

## Consulte también

[Errores de transporte de XTF (tema con NDA)](/tools/tools-console/commandlinetools/xtf-transport-errors)\
[XtfRegisterPackage](/reference/tools/xtf/xtfapi/functions/xtfregisterpackage-xtfapi-xbox-windows-m)\
[XtfRegisterNetworkSharePackage](/reference/tools/xtf/xtfapi/functions/xtfregisternetworksharepackage-xtfapi-xbox-windows-m)\
[API de Xtf adicionales](/reference/tools/xtf/xtfapi/atoc-xtfapi)


## Related topics

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