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

# XtfCreateApplicationClient

> XtfCreateApplicationClient

# XtfCreateApplicationClient

Inicializa uma nova instância da interface [IXtfApplicationClient](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t) para o console de desenvolvimento com o endereço especificado.

<a id="syntaxSection" />

## Sintaxe

```cpp theme={null}
HRESULT XtfCreateApplicationClient(
         LPCWSTR pszAddress,
         REFIID riid,
         void **ppvObject
)  
```

<a id="parametersSection" />

### Parâmetros

*pszAddress*\
Tipo: LPCWSTR

Um ponteiro para o endereço IP de ferramentas do console de desenvolvimento a ser usado para o novo [IXtfApplicationClient](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t).

*riid*\
Tipo: REFIID

Um ponteiro que recebe o identificador de instância do [IXtfApplicationClient](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t) recém-criado.

*ppvObject*\
Tipo: void\*\*

Um ponteiro que recebe uma referência ao [IXtfApplicationClient](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t) recém-criado.

<a id="retvalSection" />

### Valor retornado

Tipo: HRESULT

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

<a id="remarksSection" />

## Comentários

Essa função cria e anexa uma nova instância de [IXtfApplicationClient](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t) ao console de desenvolvimento especificado em `pszAddress`. Em seguida, você pode usar a nova instância de `IXtfApplicationClient` para esse console de implantação a fim de implantar e desinstalar aplicativos; iniciar, encerrar, restringir, remover restrições, suspender, retomar e consultar o estado de execução de aplicativos; e obter e definir informações sobre aplicativos.

Para obter mais informações sobre as APIs de ferramentas e automação disponíveis, como o XBOX Tools Framework (XTF), confira [APIs de ferramentas e automação (tópico NDA)](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/debug/atoc-api-tools-dev-env).

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** xtfapplication.h

**Biblioteca:** xtfapplication.lib

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

<a id="seealsoSection" />

## Confira também

[IXtfApplicationClient](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t)\
[XtfApplication](/pt-BR/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n)


## Related topics

- [IXtfApplicationClient::Constrain](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/constrain-ixtfapplicationclient-xtfapplication-xbox-windows-m.md)
- [IXtfApplicationClient::Deploy](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/deploy-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [IXtfApplicationClient::Launch](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/launch-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [IXtfApplicationClient::Resume](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/resume-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [IXtfApplicationClient::Snap](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/snap-ixtfapplicationclient-xtfapplication-xbox-windows-m.md)