> ## 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 um pacote implantado na unidade especificada.

## Sintaxe

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

### Parâmetros

*address*\
Tipo: LPCWSTR

\[in] O endereço do console.

*packageFullName*\
Tipo: PCWSTR

\[in] O nome completo do pacote a ser registrado.

*drive*\
Tipo: DWORD

\[in] A unidade na qual registrar o pacote. Esse parâmetro aceita os seguintes valores:

| Valor | Descrição |
| - | - |
| 0 | Unidade de varejo |
| 1 | Unidade de desenvolvimento |
| 2 - 8 | Unidade externa 1 até unidade externa 7 |

*packageInfo*\
Tipo: XtfPackageInfo\*

\[out] Objeto de informações do pacote sobre o pacote que foi registrado.

### Valor retornado

Tipo: HRESULT

Retorna `S_OK` se for bem-sucedido; caso contrário, retorna um código de erro HRESULT.

## Comentários

Essa função registra um pacote implantado em uma unidade especificada, como uma unidade externa, e fornece informações do pacote como uma referência de objeto `XtfPackageInfo`. Use as funções [XtfGetPackageFullName](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgetpackagefullname-xtfapi-xbox-windows-m.md), [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 obter o nome completo do pacote e as AUMIDs (Application User Model IDs) do pacote registrado a partir do objeto `XtfPackageInfo`. Use [XtfClosePackageInfo](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfclosepackageinfo-xtfapi-xbox-windows-m.md) para liberar o objeto `XtfPackageInfo` quando terminar de usá-lo.

Para obter mais informações sobre como gerenciar aplicativos, confira [Gerenciamento de aplicativos (xbapp.exe) (tópico sob NDA)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbapp.md).

## 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)](https://docs.xbox.com/pt-BR/home/setup-install/concepts/deployment.md)\
[Erros de transporte do XTF (tópico sob NDA)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xtf-transport-errors.md)\
[APIs adicionais do Xtf](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/atoc-xtfapi.md)


## Related topics

- [APIs adicionais do Xtf (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/atoc-xtfapi.md)
- [XtfRegisterAllPackagesOnDrive](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfregisterallpackagesondrive-xtfapi-xbox-windows-m.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)
- [XtfUnregisterPackage](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfunregisterpackage-xtfapi-xbox-windows-m.md)