Compartir a través de


Función InternetGetCookieEx2 (wininet.h)

Recupera una o varias cookies asociadas a la dirección URL especificada.

Sintaxis

DWORD InternetGetCookieEx2(
  PCWSTR           pcwszUrl,
  PCWSTR           pcwszCookieName,
  DWORD            dwFlags,
  INTERNET_COOKIE2 **ppCookies,
  PDWORD           pdwCookieCount
);

Parámetros

pcwszUrl

Dirección URL para la que se van a recuperar las cookies.

pcwszCookieName

Nombre de la cookie que se va a recuperar. Puede ser NULL.

dwFlags

Marcas de la cookie que se van a recuperar. Están disponibles las siguientes marcas.

Valor Significado
INTERNET_COOKIE_THIRD_PARTY Recupere cookies como terceros, lo que hace que se excluyan cookies de solo terceros.
INTERNET_COOKIE_NON_SCRIPT Indique que esta consulta no se desencadenó a través de JavaScript, lo que permite la recuperación de cookies solo HTTP.
INTERNET_COOKIE_SAME_SITE_LEVEL_CROSS_SITE Recupere cookies como si estuviera en un contexto entre sitios, excluyendo las cookies con el conjunto de propiedades SameSite.
INTERNET_FLAG_RESTRICTED_ZONE Recupere solo las cookies que se permitirían si la dirección URL especificada no fuera de confianza; es decir, si pertenece a la zona URLZONE_UNTRUSTED.

ppCookies

Puntero que recibe una matriz de estructuras de INTERNET_COOKIE2 . InternetFreeCookies debe liberar la matriz devuelta.

pdwCookieCount

Puntero a un DWORD que recibe el número de estructuras de la matriz.

Valor devuelto

Devuelve ERROR_SUCCESS si se ejecuta correctamente o un código de error del sistema en caso de error.

Comentarios

Nota

WinINet no admite implementaciones de servidor. Además, no se debe usar desde un servicio. En el caso de las implementaciones de servidor o los servicios, use los servicios HTTP de Microsoft Windows (WinHTTP).

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8.1 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 R2 [solo aplicaciones de escritorio]
Encabezado wininet.h
Library Wininet.lib
Archivo DLL Wininet.dll

Consulte también

HTTP Cookies

Administración de cookies

InternetSetCookieEx2

InternetFreeCookies

Funciones de WinINet