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

# DeployToTitleScratch

> IXtfApplicationClient::DeployToTitleScratch

# IXtfApplicationClient::DeployToTitleScratch

Implanta o pacote do aplicativo especificado.

## Sintaxe

```cpp theme={null}
public:
HRESULT DeployToTitleScratch(
         LPCWSTR pszDeployFilepath,
         LPCWSTR pszTitleScratchRelativePath,
         BOOL fRemoveExtraFiles,
         IXtfDeployCallback *pCallback,
         BOOL *pfCanceled,
         int *pdwResult,
         LPBSTR pbstrPackageFullName,
         LPBSTR pbstrAumidJson
)  
```

### Parâmetros

*pszDeployFilepath*\
Tipo: LPCWSTR

O *caminho de origem* do conteúdo que será implantado.

*pszTitleScratchRelativePath*\
Tipo: LPCWSTR

Um ponteiro para o caminho, relativo à pasta raiz da unidade de rascunho do título, no qual o pacote do aplicativo será implantado. Para implantações do Game Core, rascunho do título neste contexto se refere à unidade de rascunho compartilhada do sistema, ou D:, que é acessível tanto pelo System OS quanto pelo Game OS.

*fRemoveExtraFiles*\
Tipo: BOOL

Especifique TRUE para remover arquivos que já estão no console de desenvolvimento, mas não fazem parte do pacote de implantação; caso contrário, FALSE para mantê-los.

*pCallback*\
Tipo: IXtfDeployCallback\*

Um ponteiro para o retorno de chamada [IXtfDeployCallback](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/ixtfdeploycallback-xtfapplication-xbox-microsoft-t.md) a ser invocado quando ocorrer uma ação rastreável durante a implantação. Defina como `nullptr` se não quiser retornos de chamada durante a implantação.

*pfCanceled*\
Tipo: BOOL\*

Um ponteiro que recebe um valor booliano que indica se a implantação foi cancelada.

*pdwResult*\
Tipo: int\*

Um ponteiro que recebe o HRESULT da operação de implantação. Por exemplo, se um identificador de arquivo aberto impedir que um arquivo seja excluído, este parâmetro receberá o código de erro HRESULT.

*pbstrPackageFullName*\
Tipo: LPBSTR

Um ponteiro que recebe o nome completo do pacote do aplicativo implantado, incluindo o número de versão, a arquitetura e a cultura.

*pbstrAumidJson*\
Tipo: LPBSTR

Um ponteiro que recebe uma representação JSON de uma lista dos AUMIDs associados ao pacote do aplicativo. Todos os AUMIDs da lista compartilham o mesmo `PackageFamilyName`, mas têm AppIds diferentes após o ponto de exclamação ("!") em cada AUMID.

### Valor de retorno

Tipo: HRESULT

Retorna `S_OK` se tiver êxito; caso contrário, retorna um código de erro HRESULT.

## Comentários

Este método executa uma implantação por push do seu título em um kit de desenvolvimento XBOX para testes. Seu título é implantado na unidade de rascunho do título, na pasta especificada em `pszDeployFilepath`. Depois que o método conclui a implantação com êxito, seu título está pronto para ser iniciado. Para obter mais informações sobre a implantação de pacotes de aplicativos, confira [Implantar seu título no XBOX Development Kit (tópico sob NDA)](https://docs.xbox.com/pt-BR/home/setup-install/concepts/deployment.md).

> [!NOTE]
>
> Esta função é executada de forma síncrona.

Este método é semelhante ao comando `xbapp deploy` da ferramenta Gerenciamento de aplicativos (xbapp.exe), incluída como parte do XBOX Tools Framework (XTF). Para obter mais informações sobre o comando `xbapp deploy`, confira [Gerenciamento de aplicativos (xbapp.exe) (tópico sob NDA)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbapp.md).

### Como lidar com ponteiros LPBSTR

Para obter mais informações sobre como lidar com ponteiros LPBSTR retornados por esta função, confira [Alocando e liberando memória para um BSTR](https://learn.microsoft.com/cpp/atl-mfc-shared/allocating-and-releasing-memory-for-a-bstr?view=vs-2019).

## Requisitos

**Cabeçalho:** xtfapplication.h

**Biblioteca:** xtfapplication.lib

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

## Confira também

[IXtfApplicationClient](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t.md)\
[XtfApplication](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n.md)


## Related topics

- [Interface IXtfApplicationClient (conteúdo da interface)](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t.md)
- [Página Scratch](https://docs.xbox.com/pt-BR/tools/tools-console/wdp/windows-device-portal-on-xbox-scratch.md)
- [Deploy](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/deploy-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [Cópia de arquivos (xbcp.exe)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbcp.md)
- [Exclusão de arquivos (xbdel.exe)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbdel.md)