Windows desktop applications
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IInternetSecurityManager::ProcessUrlAction 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(
  [in]  LPCWSTR pwszUrl,
  [in]  DWORD   dwAction,
  [out] BYTE    *pPolicy,
  [in]  DWORD   cbPolicy,
  [in]  BYTE    *pContext,
  [in]  DWORD   cbContext,
  [in]  DWORD   dwFlags,
  [in]  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.

Return codeDescription
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 Warning:  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).
 

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

DLL

Urlmon.dll

See also

IInternetSecurityManager
ProcessUrlActionEx2

 

 

Show:
© 2016 Microsoft