FaultInIEFeature function

This synchronous function is invoked by the client of a Windows Internet Explorer feature before the client accesses the feature.

Syntax

C++
Copy 

HRESULT FaultInIEFeature(
  _In_    HWND         hWnd,
  _In_    uCLSSPEC     *pClassSpec,
  _Inout_ QUERYCONTEXT *pQuery,
  _In_    DWORD        dwFlags
);

Parameters

hWnd [in]

A handle to the parent window of the HTML dialog box.

pClassSpec [in]

A pointer to a union that provides ways of mapping to a CLSID. Note that uCLSSPEC is defined in sdk\inc\wtypes.h.

pQuery [in, out]

A ointer to a structure that contains a list of attributes used to look up a class implementation. The installed version number is returned in FIEF_FLAG_PEEK, which is passed in.

dwFlags [in]

The control behavior. The following values are valid.

FIEF_FLAG_FORCE_JITUI (0x0001)

Force JIT, even if the user has canceled a previous JIT in the same session, or has specified to Never JIT this feature. Note: For Internet Explorer 7, this flag is not respected; it is overridden by E_ACCESSDENIED.

FIEF_FLAG_PEEK (0x0002)

Do not faultin, just peek. Note: Peek also returns the currently installed version in the QUERYCONTEXT. For Internet Explorer 7, it disables the Java dialog box.

FIEF_FLAG_SKIP_INSTALLED_VERSION_CHECK (0x0004)

Ignores local version as being satisfactory and forces JIT download. Typically, this is called by code download, or by another caller after a CoCreateInstance call has failed with REGDB_E_CLASSNOTREG or ERROR_MOD_NOT_FOUND (missing a dependency DLL). Note: The registry might show that this feature is installed when it is not, or when it is damaged. For Internet Explorer 7, this flag is not respected; it is overridden by E_ACCESSDENIED.

Return value

Returns one of the following values.

Return codeDescription
S_OK

Behavior is installed. Call CoCreateInstance or IMoniker::BindToObject or another system service to invoke the class or MIME handler.

S_FALSE

The class or MIME handler is not part of an Internet Explorer feature. Call CoCreateInstance, IMoniker::BindToObject, or some other system service to invoke the class or MIME handler. Active setup settings are not found in registry.

E_ACCESSDENIED

The administrator has turned off the JIT feature.

 

Remarks

If the feature is already installed, then the function succeeds and the client should attempt to access the feature. Successful return does not guarantee that the feature is fully installed, or that the feature will work. The client should still provide access to the feature with proper error checking.

Note  The importance of this function degraded significantly after Microsoft Internet Explorer 6 SP1b and Windows XP, due to a lack of dependence on JIT in components.
 

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Product

Internet Explorer 4.0

Header
Urlmon.h

Library
Urlmon.lib

DLL
Urlmon.dll

 

 

Show: