Função PrivacyGetZonePreferenceW (wininet.h)
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.
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