Função PrivacyGetZonePreferenceW (wininet.h)

  • Artigo

Recupera as configurações de privacidade de um determinado URLZONE e PrivacyType.

Sintaxe

DWORD PrivacyGetZonePreferenceW(
  [in]                DWORD   dwZone,
  [in]                DWORD   dwType,
  [out, optional]     LPDWORD pdwTemplate,
  [out, optional]     LPWSTR  pszBuffer,
  [in, out, optional] LPDWORD pdwBufferLength
);

Parâmetros

[in] dwZone

Um valor do tipo DWORD que especifica a URLZONE para a qual as configurações de privacidade estão sendo recuperadas.

[in] dwType

Um valor do tipo DWORD que especifica o PrivacyType para o qual as configurações de privacidade estão sendo recuperadas.

[out, optional] pdwTemplate

Um LPDWORD que retorna um ponteiro para um DWORD que contém qual dos PrivacyTemplates está em uso para este dwZone e dwType.

[out, optional] pszBuffer

Um LPWSTR que aponta para um buffer que contém um LPCWSTR que representa uma versão de cadeia de caracteres do pdwTemplate ou uma cadeia de caracteres personalizada se o pdwTemplate estiver definido como PRIVACY_TEMPLATE_CUSTOM. Consulte PrivacySetZonePreferenceW para obter uma descrição de uma cadeia de caracteres de preferências de privacidade personalizada.

[in, out, optional] pdwBufferLength

Um LPDWORD que contém o comprimento do buffer em caracteres. Se o comprimento do buffer não for suficiente, PrivacyGetZonePreferenceW retornará com esse parâmetro definido como o número de caracteres necessários e com um valor retornado de ERROR_MORE_DATA.

Retornar valor

Retorna zero se bem-sucedido. Caso contrário, uma das Mensagens de Erro definidas em winerr.h será retornada.

Comentários

Essas configurações de privacidade para a zona da Internet são encontradas na guia Privacidade da caixa de diálogo Opções da Internet.

Como todos os outros aspectos da API WinINet, essa função não pode ser chamada com segurança de dentro do DllMain ou dos construtores e destruidores de objetos globais.

Nota O WinINet não dá suporte a implementações de servidor. Além disso, ele não deve ser usado de um serviço. Para implementações ou serviços de servidor, use Os Serviços HTTP do Microsoft Windows (WinHTTP).
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wininet.h (inclua Wininet.h)
Biblioteca Wininet.lib
DLL Wininet.dll

Confira também

InternetClearAllPerSiteCookieDecisions

InternetEnumPerSiteCookieDecision

InternetGetPerSiteCookieDecision

InternetSetPerSiteCookieDecisions

PrivacySetZonePreferenceW