Função InternetEnumPerSiteCookieDecisionW (wininet.h)

  • Artigo

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 InternetEnumPerSiteCookieDecisionW(
  [out]     LPWSTR        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 long sem sinal que especifica o índice do site e a configuração de cookie correspondente a ser recuperada.

Retornar valor

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

Comentários

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

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

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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, Winineti.h)
Biblioteca Wininet.lib
DLL Wininet.dll

Confira também

InternetClearAllPerSiteCookieDecisions

InternetGetPerSiteCookieDecision

InternetSetPerSiteCookieDecision

PrivacyGetZonePreferenceW

PrivacySetZonePreferenceW