Método IAppManagementHandler::EnforceApp

O IAppManagementHandler::EnforceApp método, no Configuration Manager, inicia a instalação de uma aplicação específica.

Se o processador suportar a restabelecimento de ligação, terá de devolver uma instância de restabelecimento de ligação válida a ppReconnectData. Se, por qualquer motivo, a instalação não puder ser iniciada, mas não estiver num estado de erro, por exemplo, nenhum token de utilizador a apresentar, o processador deverá devolver S_FALSE.

Sintaxe

[IDL]
HRESULT EnforceApp(
     AppAction eEnforceAction,
     HANDLE hUserToken,
     DWORD dwSessionId,
     IWbemClassObject* pHandlerSynclet,
     LPCWSTR szLocalContentPath,
     HANDLE* phInstallProcess,
     DWORD* pdwExitCode,
     LPWSTR* ppszExecutionStatus,
     IWbemClassObject** ppReconnectData
);

Parâmetros

eEnforceAction Tipo de dados: AppAction

Qualificadores: [in]

.

hUserToken Tipo de dados: HANDLE

Qualificadores: [in]

.

dwSessionId Tipo de dados: DWORD

Qualificadores: [in]

.

pHandlerSynclet Tipo de dados: IWbemClassObject

Qualificadores: [in]

.

szLocalContentPath Tipo de dados: LPCWSTR

Qualificadores: [in]

.

phInstallProcess Tipo de dados: HANDLE

Qualificadores: [fora]

.

pdwExitCode Tipo de dados: DWORD

Qualificadores: [fora]

.

ppszExecutionStatus Tipo de dados: LPWSTR

Qualificadores: [fora]

.

ppReconnectData Tipo de dados: IWbemClassObject

Qualificadores: [fora]

.

Return Values

Um HRESULT código. Os valores possíveis incluem, mas não estão limitados, o seguinte:

S_OK O método foi bem-sucedido. Todos os outros valores devolvidos indicam uma falha. Se, por qualquer motivo, a instalação não puder ser iniciada, mas não estiver num estado de erro, por exemplo, sem token de utilizador para apresentar a IU, o processador deverá devolver S_FALSE

Requisitos

Requisitos de Runtime

Para obter mais informações, veja Configuration Manager Client Runtime Requirements (Requisitos de Runtime de Cliente do Configuration Manager).

Requisitos de Desenvolvimento

Para obter mais informações, veja Configuration Manager Client Development Requirements (Requisitos de Desenvolvimento de Clientes).

Confira também

Interfaces de Cliente de Gestão de Aplicações da Interface IAppManagementHandlerConfiguration Manager Software Development KitConfiguration Manager Referência