Función InternetGetCookieExW (wininet.h)
La función
Sintaxis
BOOL InternetGetCookieExW(
[in] LPCWSTR lpszUrl,
[in] LPCWSTR lpszCookieName,
[in, out, optional] LPWSTR lpszCookieData,
[in, out] LPDWORD lpdwSize,
[in] DWORD dwFlags,
[in] LPVOID lpReserved
);
Parámetros
[in] lpszUrl
Puntero a un cadena terminadanull que contiene la dirección URL con la que está asociada la cookie que se va a recuperar. Este parámetro no se puede NULL ni error InternetGetCookieEx y devuelve un error de ERROR_INVALID_PARAMETER.
[in] lpszCookieName
Puntero a un cadena terminadanull que contiene el nombre de la cookie que se va a recuperar. Este nombre distingue mayúsculas de minúsculas.
[in, out, optional] lpszCookieData
Puntero a un búfer para recibir los datos de la cookie.
[in, out] lpdwSize
Puntero a una variable DWORD.
En la entrada, la variable debe contener el tamaño, en TCHAR, del búfer al que apunta el parámetro pchCookieData.
Al salir, si la función se ejecuta correctamente, esta variable contiene el número de TCHAR de datos de cookies copiados en el búfer. Si se pasó NULL como parámetro lpszCookieData, o si la función produce un error de ERROR_INSUFFICIENT_BUFFER, la variable contiene el tamaño, en BYTEs, del búfer necesario para recibir los datos de la cookie.
Este parámetro no se puede NULL ni error InternetGetCookieEx y devuelve un error de ERROR_INVALID_PARAMETER.
[in] dwFlags
Marca que controla cómo la función recupera datos de cookies. Este parámetro puede ser uno de los siguientes valores.
[in] lpReserved
Reservado para uso futuro. Establezca en null.
Valor devuelto
Si la función se ejecuta correctamente, la función devuelve TRUE.
Si se produce un error en la función, devuelve FALSE. Para obtener un valor de error específico, llame a GetLastError.
Si NULL se pasa a lpszCookieData, la llamada se realizará correctamente y la función no establecerá ERROR_INSUFFICIENT_BUFFER.
Esta función puede establecer los siguientes códigos de error.
Código devuelto | Descripción |
---|---|
|
Se devuelve si los datos de cookies recuperados son mayores que el tamaño del búfer al que apunta el parámetro pcchCookieData o si ese parámetro es NULL. |
|
Se devuelve si el pchURL de |
|
Se devuelve si no se pueden recuperar datos cookied como se ha especificado. |
Observaciones
Nota
El encabezado wininet.h define InternetGetCookieEx 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 |