Função InternetEnumPerSiteCookieDecisionA (wininet.h)

Artigo
11/20/2024

Recupera os domínios e as configurações de cookie de sites para os quais os regulamentos de cookie específicos do site são definidos.

Sintaxe

BOOL InternetEnumPerSiteCookieDecisionA(
  [out]     LPSTR         pszSiteName,
  [in, out] unsigned long *pcSiteNameSize,
  [out]     unsigned long *pdwDecision,
  [in]      unsigned long dwIndex
);

Parâmetros

[out] pszSiteName

Um LPSTR que recebe uma cadeia de caracteres especificando um domínio do site.

[in, out] pcSiteNameSize

Um ponteiro para um longo sem sinal que especifica o tamanho do parâmetro pcSiteNameSize fornecido para a função InternetEnumPerSiteCookieDecision quando ele é chamado. Quando InternetEnumPerSiteCookieDecision retorna, pcSiteNameSize recebe o comprimento real da cadeia de caracteres de domínio retornada em pszSiteName.

[out] pdwDecision

Ponteiro para um longo sem sinal que recebe o valor de enumeração InternetCookieState correspondente a pszSiteName.

[in] dwIndex

Um longo sem sinal que especifica o índice do site e a configuração de cookie correspondente a ser recuperada.

Valor de retorno

VERDADEIRO se a função recuperou a configuração de cookie para o domínio determinado; caso contrário, false. falso.

Observações

InternetEnumPerSiteCookieDecision deve ser inicialmente chamado com dwIndex igual a 0. Incrementando as etapas de parâmetro dwIndex por meio da lista de sites e configurações de cookie. O final da lista é atingido quando InternetEnumPerSiteCookieDecision retorna FALSE e produz o erro wininet, ERROR_NO_MORE_ITEMS.

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 InternetEnumPerSiteCookieDecision 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 (inclua Wininet.h, Winineti.h)
biblioteca	Wininet.lib
de DLL	Wininet.dll

Consulte também

InternetClearAllPerSiteCookieDecisions

InternetGetPerSiteCookieDecision

InternetSetPerSiteCookieDecision

PrivacyGetZonePreferenceW

PrivacySetZonePreferenceW

Compartilhar via