IInternetHostSecurityManager::ProcessUrlAction

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method retrieves the policy associated with the URL action in the specified context.

Syntax

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

Parameters

  • dwAction
    [in] Unsigned long integer value that specifies the action to process. This can be one of the URL action flag values.
  • pPolicy
    [out] Address of the output buffer to store the policy. Because all the URLPOLICY_* values are DWORD values, the buffer should be greater than or equal to the size of a DWORD. This can contain one of the URL policy flag values.
  • cbPolicy
    [in] Unsigned long integer value that specifies the size of the output buffer.
  • pContext
    [in] Address of a buffer that contains the context information used by the delegation routines.
  • cbContext
    [in] Unsigned long integer value that specifies the size of the context information buffer.
  • dwFlags
    [in] Unsigned long integer value that contains the flags controlling this method. This can be one of the PUAF values.
  • dwReserved
    [in] Reserved. Must be set to zero.

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

The method can also return an HRESULT, derived from the Microsoft® 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