IAppManagementHandler::EnforceApp Method

The IAppManagementHandler::EnforceApp method, in Configuration Manager, starts the installation of a specific application.

If the handler supports reconnection, it must return a valid reconnect instance to ppReconnectData. If for whatever reason the installation cannot start, but is not in an error state, for example, no user token to display, then the handler should return S_FALSE.

Syntax

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

Parameters

eEnforceAction Data type: AppAction

Qualifiers: [in]

.

hUserToken Data type: HANDLE

Qualifiers: [in]

.

dwSessionId Data type: DWORD

Qualifiers: [in]

.

pHandlerSynclet Data type: IWbemClassObject

Qualifiers: [in]

.

szLocalContentPath Data type: LPCWSTR

Qualifiers: [in]

.

phInstallProcess Data type: HANDLE

Qualifiers: [out]

.

pdwExitCode Data type: DWORD

Qualifiers: [out]

.

ppszExecutionStatus Data type: LPWSTR

Qualifiers: [out]

.

ppReconnectData Data type: IWbemClassObject

Qualifiers: [out]

.

Return Values

An HRESULT code. Possible values include, but are not limited to, the following:

S_OK The method succeeded. All other return values indicate failure. If for whatever reason the installation cannot start, but is not in an error state, for example, no user token to display UI, then the handler should return S_FALSE

Requirements

Runtime Requirements

For more information, see Configuration Manager Client Runtime Requirements.

Development Requirements

For more information, see Configuration Manager Client Development Requirements.

See Also

IAppManagementHandler Interface Application Management Client Interfaces Configuration Manager Software Development Kit Configuration Manager Reference