IInternetHostSecurityManager::ProcessUrlAction 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 Flags 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 Flags 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:

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 Win32® error code ERROR_NOT_FOUND to indicate that the URL action could not be read from the registry.