Determines the policy for the specified action and displays a user interface, if the policy indicates that the user should be queried.

Syntax

HRESULT ProcessUrlAction(      
    LPCWSTR pwszUrl,
    DWORD dwAction,
    BYTE *pPolicy,
    DWORD cbPolicy,
    BYTE *pContext,
    DWORD cbContext,
    DWORD dwFlags,
    DWORD dwReserved
);

Parameters

pwszUrl

[in] A constant pointer to a wide character string that specifies the URL.

dwAction

[in] A DWORD that specifies the action to be performed. This can be one of the URL Action Flags values.

pPolicy

[out] Required. A pointer to a buffer that receives the policy and action for the specified URL. This must be one of the URL Policy Flags values.

cbPolicy

[in] A DWORD that specifies the size of the buffer pPolicy.

pContext

[in] A pointer to a buffer that contains the context information (a CLSID) used by the delegation routines. Can be set to NULL.

cbContext

[in] A DWORD that specifies the size of the buffer cbContext.

dwFlags

[in] A DWORD that specifies a PUAF enumeration value or values.

dwReserved

[in] Reserved. Must be set to NULL.

Return Value

Returns one of the following values.

S_OK	Success. The URL policy is URLPOLICY_ALLOW.
S_FALSE	Found a valid URL policy that is not URLPOLICY_ALLOW.
E_OUTOFMEMORY	There is not enough memory to complete the operation.
E_INVALIDARG	URI is null.
E_UNEXPECTED	Failed to initialize the ZoneManager.

Remarks

This method can also return an HRESULT derived from the Microsoft Win32 error code ERROR_NOT_FOUND to indicate that the URL action cannot be read from the registry.

Security Alert  Incorrect implementation this method can compromise the security of your application. A custom implementation of IInternetSecurityManager::ProcessUrlAction should only process URL actions that the default application cannot or should not handle. For all other URL actions, this method should return INET_E_DEFAULT_ACTION. Attempting to duplicate the default implementation might result in incorrectly processing URL actions and might leave users susceptible to elevation of privilege attacks. Review Security Considerations: URL Security Zones API before continuing.

Microsoft Internet Explorer 6 for Windows XP Service Pack 2 (SP2) and later. Use the CoInternetIsFeatureEnabledForUrl function instead of this method to determine the URL policy for the URLACTION_FEATURE_MIME_SNIFFING URL action, the URLACTION_FEATURE_WINDOW_RESTRICTIONS URL action, or the URLACTION_FEATURE_ZONE_ELEVATION URL action.

Note  If you create your own implementation of this method, you must set the pPolicy value before you return a success code (S_OK or S_FALSE).

See Also

IInternetSecurityManagerEx2::ProcessUrlActionEx2