Функция InternetEnumPerSiteCookieDecisionA (wininet.h)

Статья
11/20/2024

Извлекает домены и параметры файлов 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

Указатель на неподписанный длинный объект, который получает значение перечисления InternetCookieState, соответствующее значению перечисления pszSiteName.

[in] dwIndex

Без знака, указывающий индекс веб-сайта и соответствующий параметр cookie для извлечения.

Возвращаемое значение

TRUE, если функция извлекла параметр cookie для заданного домена; в противном случае значение false. FALSE.

Замечания

InternetEnumPerSiteCookieDecision сначала следует вызывать с dwIndex равным 0. Добавив параметр dwIndex dwIndex по списку веб-сайтов и параметров файлов cookie. Конец списка достигается, когда InternetEnumPerSiteCookieDecis ion возвращает false и создает ошибку wininet, ERROR_NO_MORE_ITEMS.

Как и все остальные аспекты API WinINet, эта функция не может быть безопасно вызвана из dllMain или конструкторов и деструкторов глобальных объектов.

Примечание WinINet не поддерживает реализации сервера. Кроме того, его не следует использовать из службы. Для реализации или служб сервера microsoft Windows HTTP Services (WinHTTP).

Заметка

Заголовок wininet.h определяет InternetEnumPerSiteCookieDecision в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	wininet.h (include Wininet.h, Winineti.h)
библиотеки	Wininet.lib
DLL	Wininet.dll

См. также

InternetClearAllPerSiteCookieDecisions

InternetGetPerSiteCookieDecision

InternetSetPerSiteCookieDecision

PrivacyGetZonePreferenceW

PrivacySetZonePreferenceW

Поделиться через