Función InternetSetCookieExA (wininet.h)
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:
[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:
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 |