Função InternetEnumPerSiteCookieDecisionA (winineti.h)
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 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.
Observação
O cabeçalho winineti.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 | winineti.h (inclua Wininet.h, Winineti.h) |
| Biblioteca | Wininet.lib |
| DLL | Wininet.dll |
Confira também
InternetClearAllPerSiteCookieDecisions
InternetGetPerSiteCookieDecision