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

# XtfRegisterPackageOnDrive

> XtfRegisterPackageOnDrive

# XtfRegisterPackageOnDrive

Registra un paquete implementado en la unidad especificada.

## Sintaxis

```cpp theme={null}
HRESULT XtfRegisterPackageOnDrive(
         LPCWSTR address,
         PCWSTR packageFullName,
         DWORD drive,
         XtfPackageInfo* packageInfo
)  
```

### Parámetros

*address*\
Tipo: LPCWSTR

\[in] La dirección de la consola.

*packageFullName*\
Tipo: PCWSTR

\[in] El nombre completo del paquete que se va a registrar.

*drive*\
Tipo: DWORD

\[in] La unidad en la que se registra el paquete. Este parámetro acepta los siguientes valores:

| Valor | Descripción |
| - | - |
| 0 | Unidad comercial |
| 1 | Unidad de desarrollo |
| 2 - 8 | Unidad externa 1 a unidad externa 7 |

*packageInfo*\
Tipo: XtfPackageInfo\*

\[out] Objeto de información de paquete sobre el paquete que se registró.

### Valor devuelto

Tipo: HRESULT

Devuelve `S_OK` si se ejecuta correctamente; de lo contrario, devuelve un código de error HRESULT.

## Comentarios

Esta función registra un paquete implementado en una unidad especificada, como una unidad externa, y proporciona información del paquete como una referencia de objeto `XtfPackageInfo`. Use las funciones [XtfGetPackageFullName](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/functions/xtfgetpackagefullname-xtfapi-xbox-windows-m.md), [XtfGetCountofAppUserModelIds](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/functions/xtfgetcountofappusermodelids-xtfapi-xbox-windows-m.md) y [XtfGetAumid](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/functions/xtfgetaumid-xtfapi-xbox-windows-m.md) para obtener el nombre completo del paquete y los identificadores de modelo de usuario de aplicación (AUMID) del paquete registrado a partir del objeto `XtfPackageInfo`. Use [XtfClosePackageInfo](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/functions/xtfclosepackageinfo-xtfapi-xbox-windows-m.md) para liberar el objeto `XtfPackageInfo` cuando haya terminado de usarlo.

Para obtener más información sobre la administración de aplicaciones, consulte [Administración de aplicaciones (xbapp.exe) (tema con NDA)](https://docs.xbox.com/es/tools/tools-console/commandlinetools/xbapp.md).

## Requisitos

**Encabezado:** xtfapi.h

**Biblioteca:** XtfApi.lib

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

## Consulte también

[Implementación de ejecución desde PC (tema con NDA)](https://docs.xbox.com/es/home/setup-install/concepts/deployment.md)\
[Errores de transporte de XTF (tema con NDA)](https://docs.xbox.com/es/tools/tools-console/commandlinetools/xtf-transport-errors.md)\
[API de Xtf adicionales](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/atoc-xtfapi.md)


## Related topics

- [API de Xtf adicionales (contenido de la API)](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/atoc-xtfapi.md)
- [XtfRegisterAllPackagesOnDrive](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/functions/xtfregisterallpackagesondrive-xtfapi-xbox-windows-m.md)
- [XtfRegisterPackage](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/functions/xtfregisterpackage-xtfapi-xbox-windows-m.md)
- [XtfRegisterNetworkSharePackage](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/functions/xtfregisternetworksharepackage-xtfapi-xbox-windows-m.md)
- [XtfUnregisterPackage](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/functions/xtfunregisterpackage-xtfapi-xbox-windows-m.md)