Share via


IInternetSecurityManager::ProcessUrlAction

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method 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] Constant pointer to a wide character string that specifies the URL.
  • dwAction
    [in] DWORD that specifies the action to be performed. This can be one of the URL action flag values.
  • pPolicy
    [out] Pointer to a buffer that receives the policy and action for the specified URL. This can be one of the URL policy flag values.
  • cbPolicy
    [in] DWORD that specifies the size of the buffer pPolicy.
  • pContext
    [in] Pointer to a buffer that contains the context information (a CLSID) used by the delegation routines. May be set to NULL.
  • cbContext
    [in] DWORD that specifies the size of the buffer cbContext.
  • dwFlags
    [in] DWORD that specifies a PUAF enumeration value.
  • dwReserved
    [in] Reserved. Must be set to NULL.

Return Value

Returns one of the following values.

Value Description

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.

Remarks

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

Requirements

Header urlmon.h, urlmon.idl
Library urlmon.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later