IInternetSecurityManagerEx2::QueryCustomPolicyEx2 method

Gets the custom policy associated with the URL and specified key in the given context.

Syntax

HRESULT QueryCustomPolicyEx2(
  [in]  IUri    *pUri,
  [in]  REFGUID guidKey,
  [out] BYTE    **ppPolicy,
  [out] DWORD   *pcbPolicy,
  [in]  BYTE    *pContext,
  [in]  DWORD   cbContext,
  [in]  DWORD   dwReserved
);

Parameters

• pUri [in]
  A pointer to an IUri interface that specifies the URL.

• guidKey [in]
  A GUID associated with the custom policy.

• ppPolicy [out]
  A pointer to a buffer that stores the policy information.

• pcbPolicy [out]
  A pointer to a DWORD that specifies the size of the buffer returned in ppPolicy.

• pContext [in]
  A pointer to a buffer that specifies the context information.

• cbContext [in]
  A DWORD that specifies the size of the context buffer.

• dwReserved [in]
  Reserved. Must be set to 0.

Return value

Returns S_OK if successful, or E_OUTOFMEMORY if there is not enough memory to complete the operation.

This method can also return the HRESULT derived from the Win32 error code ERROR_NOT_FOUND to indicate that the action cannot be read from the registry.

Remarks

IInternetSecurityManagerEx2::QueryCustomPolicyEx2 was introduced in Windows Internet Explorer 7.

IInternetSecurityManagerEx2::QueryCustomPolicyEx2 is identical to QueryCustomPolicy except that it takes its URL from an IUri object.

The default action is to call GetZoneCustomPolicy with URLZONEREG_DEFAULT.

The caller is responsible for freeing the memory buffer returned in ppPolicy with CoTaskMemFree.

Requirements

See also

IInternetSecurityManagerEx2