PrivacyGetZonePreferenceW function

  • Article

Gets the privacy settings for a given URLZONE and PrivacyType.

Syntax

DWORD PrivacyGetZonePreferenceW(
  _In_    DWORD   dwZone,
  _In_    DWORD   dwType,
  _Out_   LPDWORD pdwTemplate,
  _Inout_ LPWSTR  pszBuffer,
  _Inout_ LPDWORD pdwBufferLength
);

Parameters

  • dwZone [in]
    A value of type DWORD that specifies the URLZONE for which privacy settings are being retrieved.

  • dwType [in]
    A value of type DWORD that specifies the PrivacyType for which privacy settings are being retrieved.

  • pdwTemplate [out]
    A LPDWORD that returns a pointer to a DWORD containing the PrivacyTemplates that is in use for this dwZone and dwType.

  • pszBuffer [in, out]
    A LPWSTR that points to a buffer containing a LPCWSTR representing a string version of the pdwTemplate, or a customized string if the pdwTemplate is set to PRIVACY_TEMPLATE_CUSTOM. See PrivacySetZonePreferenceW for a description of a customized privacy preferences string.

  • pdwBufferLength [in, out]
    A LPDWORD that contains the buffer length in characters. If the buffer length is not sufficient, PrivacyGetZonePreferenceW returns with this parameter set to the number of characters required and with a return value of ERROR_MORE_DATA.

Return value

Returns zero if successful. Otherwise, one of the Error Messages defined in winerr.h is returned.

Remarks

These privacy settings for the Internet zone are found on the Privacy tab of the Internet Options dialog box.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Product

Internet Explorer 6

Header

 Wininet.h

Library

 Wininet.lib

DLL

 Wininet.dll

Unicode and ANSI names

PrivacyGetZonePreferenceW (Unicode)

See also

PrivacySetZonePreferenceW