Função InternetGetPerSiteCookieDecisionA (wininet.h)

Artigo
11/20/2024

Recupera uma decisão sobre cookies para um determinado domínio.

Sintaxe

BOOL InternetGetPerSiteCookieDecisionA(
  [in]  LPCSTR        pchHostName,
  [out] unsigned long *pResult
);

Parâmetros

[in] pchHostName

Um LPCTSTR que aponta para uma cadeia de caracteres que contém um domínio.

[out] pResult

Um ponteiro para um longo sem sinal que contém um dos valores de enumeração InternetCookieState .

Valor de retorno

Retorna verdadeiro se a decisão foi recuperada e FALSE caso contrário.

Observações

Um valor retornado de FALSE pode indicar que o domínio pchHostName não tem regulamentos de cookie específicos do site.

O WinINet minimiza o domínio especificado no parâmetro pchHostName e define a política de cookie no domínio legal mínimo. Por exemplo, se o nome do host especificado for widgets.microsoft.com, a política será definida no nome do host minimizado microsoft.com.

Assim 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.

Observaçã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 do Microsoft Windows HTTP Services (WinHTTP).

Nota

O cabeçalho wininet.h define InternetGetPerSiteCookieDecision como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	wininet.h
biblioteca	Wininet.lib
de DLL	Wininet.dll

Consulte também

InternetClearAllPerSiteCookieDecisions

InternetEnumPerSiteCookieDecision

InternetSetPerSiteCookieDecision

PrivacyGetZonePreferenceW

PrivacySetZonePreferenceW

Compartilhar via