Edit

IeAxiService::Initialize method

  • Article

The Initialize method checks and downloads an ActiveX object. If the object meets policy requirements, this method initializes a system object that installs the ActiveX object.

Syntax

SECURITY_STATUS Initialize(
  [in]  HWND     hwndParent,
  [in]  DWORD    dwClientPID,
  [in]  BSTR     bstrDesktop,
  [in]  BSTR     bstrClsID,
  [in]  BSTR     bstrURL,
  [out] BSTR     *pbstrNonce,
  [out] IUnknown **ppISyncBrokerInterface
);

Parameters

hwndParent [in]

A handle to the parent window of the window that is attempting to install the ActiveX control.

dwClientPID [in]

The process ID of the calling process.

bstrDesktop [in]

The desktop for the object.

bstrClsID [in]

The class ID of the ActiveX object to install.

bstrURL [in]

The URL of the ActiveX object to install.

pbstrNonce [out]

A context that can be used to share state information in calls to other methods used to verify and download the ActiveX object.

ppISyncBrokerInterface [out]

A pointer to the instance of the IeAxiSystemInstaller interface that installs the ActiveX control.

Return value

If the function succeeds, the return value is S_OK.

If the function fails, the return value can be one of the following error codes.

Return code/value Description
TRUST_E_SUBJECT_NOT_TRUSTED
0x800B0004
 The ActiveX object should not be installed.

Requirements

Requirement Value
Minimum supported client
 Windows Vista Business, Windows Vista Enterprise, Windows Vista Ultimate [desktop apps only]
Minimum supported server
 None supported
IID
 IID_IeAxiService is defined as E9E92380-9ECD-4982-A0EB-6815A56CCF27

See also

IeAxiService