Функция InternetEnumPerSiteCookieDecisionA (wininet.h)
Извлекает домены и параметры файлов cookie для веб-сайтов, для которых установлены правила использования файлов cookie для конкретного сайта.
Синтаксис
BOOL InternetEnumPerSiteCookieDecisionA(
[out] LPSTR pszSiteName,
[in, out] unsigned long *pcSiteNameSize,
[out] unsigned long *pdwDecision,
[in] unsigned long dwIndex
);
Параметры
[out] pszSiteName
LPSTR, получающий строку, указывающую домен веб-сайта.
[in, out] pcSiteNameSize
Указатель на длину без знака, указывающую размер параметра pcSiteNameSize , предоставленного функции InternetEnumPerSiteCookieDecision при ее вызове. Когда internetEnumPerSiteCookieDecision возвращается, pcSiteNameSize получает фактическую длину строки домена, возвращенной в pszSiteName.
[out] pdwDecision
Указатель на неподписанный объект long, получающий значение перечисления InternetCookieState , соответствующее pszSiteName.
[in] dwIndex
Неподписанный объект long, указывающий индекс веб-сайта и соответствующий параметр файла cookie для извлечения.
Возвращаемое значение
Значение TRUE , если функция извлекла параметр cookie для заданного домена; в противном случае — false. FALSE.
Комментарии
InternetEnumPerSiteCookieDecision должен изначально вызываться с параметром dwIndex , равным 0. Приращение параметра dwIndex по шагам по списку веб-сайтов и параметров файлов cookie. Конец списка достигается, когда InternetEnumPerSiteCookieDecision возвращает значение FALSE и выдает ошибку wininet , ERROR_NO_MORE_ITEMS.
Как и все другие аспекты API WinINet, эту функцию нельзя безопасно вызывать из библиотеки DllMain или из конструкторов и деструкторов глобальных объектов.
Примечание
Заголовок wininet.h определяет InternetEnumPerSiteCookieDecision в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | wininet.h (включая Wininet.h, Winineti.h) |
| Библиотека | Wininet.lib |
| DLL | Wininet.dll |
См. также раздел
InternetClearAllPerSiteCookieDecisions
InternetGetPerSiteCookieDecision