Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
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] DWORDthat 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] DWORDthat 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] DWORDthat specifies the size of the buffer cbContext.

dwFlags

[in] DWORDthat 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