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