CoInternetIsFeatureEnabledForUrl

Declaration

HRESULT
CoInternetIsFeatureEnabledForUrl (
    INTERNETFEATURELIST FeatureEntry,
    DWORD dwFlags,
    LPCWSTR szURL,
    IInternetSecurityManager *pSecMgr);

Parameters

The FeatureEntry argument tells which feature to test. The supported Internet Features are listed separately.

The dwFlags argument tells in which context to evaluate the feature. The supported Feature Enabled Flags are listed separately.

The szURL argument is the address of a Unicode string that names the URL. This argument can be NULL.

The pSecMgr argument is the address of an IInternetSecurityManager interface that is to decide whether the feature can be disabled for the given URL. This argument can be NULL.

Return Value

The function returns S_OK if the feature is enabled, S_FALSE if the feature is disabled, else an error code.

Behaviour

This function post-processes CoInternetIsFeatureEnabled, to allow that some features can be enabled in general but disabled for a trusted URL. The overall aim is to settle the question by calling the given security manager’s ProcessUrlAction method. The feature is considered to be disabled if the security manager reports the policy permissions as URLPOLICY_ALLOW. In other words, the URL action that the security manager is asked to process is a question: do you allow the corresponding feature to be disabled for the given URL? The following table shows the relevant features and the corresponding URL actions:

It is an error (E_FAIL) to provide a FeatureEntry that is out of range.

If CoInternetIsFeatureEnabled fails for the same FeatureEntry and dwFlags, then this function returns the Internet Explorer default for the feature.

If CoInternetIsFeatureEnabled reports that the given feature is disabled in general, then the feature is also disabled whatever the URL, and this function returns S_FALSE.

If CoInternetIsFeatureEnabled reports that the given feature is enabled, but the feature is not in the above list or no URL is given, then it is not possible that the feature can be disabled for the URL, and this function returns S_OK.

Otherwise, to test the feature for the given URL, the function will call the security manager’s ProcessUrlAction method (specifying the PUAF_NOUI flag). If no security manager is given, the function uses a built-in security manager. If this does not yet exist, the function creates it. If the internal call to CoInternetCreateSecurityManager fails, then so does this function.

If the ProcessUrlAction method fails, the function returns the Internet Explorer default for the feature. If the policy returned by the method has URLPOLICY_ALLOW for the bits masked by URLPOLICY_MASK_PERMISSIONS, then the feature is considered disabled for the given URL, and the function returns S_FALSE. Otherwise, the URL has no effect on the feature and the function returns S_OK.

Availability

The CoInternetIsFeatureEnabledForUrl function is exported by name from URLMON.DLL in the version 6.00 from Windows XP SP2, and higher.

Documentation Status

Microsoft documents the CoInternetIsFeatureEnabledForUrl function, but there are some (minor) omissions and discrepancies. Microsoft does not say that pSecMgr is optional, nor that the function may return anything other than S_OK or S_FALSE. Also, Microsoft lists only three features (of the six given above) as being associated with URL actions such that this function can return a different result from CoInternetIsFeatureEnabled. In related documentation, Introduction to Feature Controls, Microsoft lists URL actions for eight features, which may be correct in some context, just not for this function.