Función InternetSetCookieExA (wininet.h)

Artículo
08/27/2023

La función InternetSetCookieEx crea una cookie con un nombre especificado asociado a una dirección URL especificada. Esta función difiere de la función InternetSetCookie al poder crear cookies de terceros.

Sintaxis

DWORD InternetSetCookieExA(
  [in] LPCSTR    lpszUrl,
  [in] LPCSTR    lpszCookieName,
  [in] LPCSTR    lpszCookieData,
  [in] DWORD     dwFlags,
  [in] DWORD_PTR dwReserved
);

Parámetros

[in] lpszUrl

Puntero a una cadena terminada en null que contiene la dirección URL para la que se debe establecer la cookie.

Si este puntero es NULL, InternetSetCookieEx produce un error de ERROR_INVALID_PARAMETER .

[in] lpszCookieName

Puntero a una cadena terminada en null que contiene el nombre que se va a asociar a esta cookie. Si este puntero es NULL, no hay ningún nombre asociado a la cookie.

[in] lpszCookieData

Puntero a una cadena terminada en null que contiene los datos que se van a asociar a la nueva cookie.

Si este puntero es NULL, InternetSetCookieEx produce un error de ERROR_INVALID_PARAMETER .

[in] dwFlags

Marcas que controlan cómo la función recupera los datos de cookies:

Value	Significado
INTERNET_COOKIE_EVALUATE_P3P	Si se establece esta marca y el parámetro dwReserved no es NULL, el parámetro dwReserved se convierte en un LPCTSTR que apunta a un encabezado Platform-for-Privacy-Protection (P3P) para la cookie en cuestión.
INTERNET_COOKIE_HTTPONLY	Habilita la recuperación de cookies marcadas como "HTTPOnly". No use esta marca si expone una interfaz que admite scripts, ya que esto tiene implicaciones de seguridad. Si expone una interfaz que admite scripts, puede convertirse en un vector de ataque para ataques de scripting entre sitios. Es absolutamente imperativo usar esta marca solo si pueden garantizar que nunca permitirá que un código de terceros establezca una cookie mediante esta marca a través de un mecanismo de extensibilidad que proporcione. Versión: Requiere Internet Explorer 8.0 o posterior.
INTERNET_COOKIE_THIRD_PARTY	Indica que la cookie que se establece es una cookie de terceros.
INTERNET_FLAG_RESTRICTED_ZONE	Indica que la cookie que se establece está asociada a un sitio que no es de confianza.

[in] dwReserved

NULL, o contiene un puntero a un encabezado Platform-for-Privacy-Protection (P3P) que se va a asociar a la cookie.

Valor devuelto

Devuelve un miembro de la enumeración InternetCookieState si se ejecuta correctamente o FALSE si se produce un error en la función. Si se produce un error, si una llamada a GetLastError devuelve ERROR_NOT_ENOUGH_MEMORY, no había suficiente memoria del sistema disponible.

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 Servicios HTTP de Microsoft Windows (WinHTTP).

Nota:

El encabezado wininet.h define InternetSetCookieEx como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos


Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wininet.h
Library	Wininet.lib
Archivo DLL	Wininet.dll