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.

[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: AppActionQualifiers: [in].  
hUserToken

Data type: HANDLEQualifiers: [in].  
dwSessionId

Data type: DWORDQualifiers: [in].  
pHandlerSynclet

Data type: IWbemClassObjectQualifiers: [in].  
szLocalContentPath

Data type: LPCWSTRQualifiers: [in].  
phInstallProcess

Data type: HANDLEQualifiers: [out].  
pdwExitCode

Data type: DWORDQualifiers: [out].  
ppszExecutionStatus

Data type: LPWSTRQualifiers: [out].  
ppReconnectData

Data type: IWbemClassObjectQualifiers: [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