Función InternetSetCookieExA (wininet.h)

Artículo
11/20/2024

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 mediante la posibilidad de 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 un cadena terminada en nullque 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 un cadena terminadanull que contiene el nombre que se va a asociar a esta cookie. Si este puntero es NULL, no se asocia ningún nombre a la cookie.

[in] lpszCookieData

Puntero a un cadena terminadanula 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 datos de cookies:

Valor	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 scriptable, 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 mediante 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.

Observaciones

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 Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	wininet.h
biblioteca de	Wininet.lib
DLL de	Wininet.dll