Funzione InternetGetCookieExA (wininet.h)

Articolo
08/27/2023

La funzione InternetGetCookieEx recupera i dati archiviati nei cookie associati a un URL specificato. A differenza di InternetGetCookie, InternetGetCookieEx può essere usato per limitare i dati recuperati a un singolo nome cookie o, per criterio, associato a siti non attendibili o cookie di terze parti.

Sintassi

BOOL InternetGetCookieExA(
  [in]                LPCSTR  lpszUrl,
  [in]                LPCSTR  lpszCookieName,
  [in, out, optional] LPSTR   lpszCookieData,
  [in, out]           LPDWORD lpdwSize,
  [in]                DWORD   dwFlags,
  [in]                LPVOID  lpReserved
);

Parametri

[in] lpszUrl

Puntatore a una stringa con terminazione null contenente l'URL con cui il cookie da recuperare è associato. Questo parametro non può essere NULL o InternetGetCookieEx non riesce e restituisce un errore di ERROR_INVALID_PARAMETER .

[in] lpszCookieName

Puntatore a una stringa con terminazione null contenente il nome del cookie da recuperare. Questo nome è distinzione tra maiuscole e minuscole.

[in, out, optional] lpszCookieData

Puntatore a un buffer per ricevere i dati dei cookie.

[in, out] lpdwSize

Puntatore a una variabile DWORD.

Nella voce la variabile deve contenere le dimensioni, in TCHARs, del buffer a cui punta il parametro pchCookieData .

In uscita, se la funzione ha esito positivo, questa variabile contiene il numero di TCHAR di dati cookie copiati nel buffer. Se NULL è stato passato come parametro lpszCookieData o se la funzione ha esito negativo con un errore di ERROR_INSUFFICIENT_BUFFER, la variabile contiene le dimensioni, in BYTEs, del buffer necessario per ricevere i dati del cookie.

Questo parametro non può essere NULL o InternetGetCookieEx non riesce e restituisce un errore di ERROR_INVALID_PARAMETER .

[in] dwFlags

Flag che controlla il modo in cui la funzione recupera i dati dei cookie. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
INTERNET_COOKIE_HTTPONLY	Abilita il recupero dei cookie contrassegnati come "HTTPOnly". Non usare questo flag se si espone un'interfaccia scriptable, perché si tratta di implicazioni per la sicurezza. È imperativo usare questo flag solo se è possibile garantire che il cookie non venga mai esposto al codice di terze parti tramite un meccanismo di estendibilità fornito. Versione: Richiede Internet Explorer 8.0 o versione successiva.
INTERNET_COOKIE_THIRD_PARTY	Recupera solo i cookie di terze parti se i criteri consentono esplicitamente a tutti i cookie di recuperare l'URL specificato.
INTERNET_FLAG_RESTRICTED_ZONE	Recupera solo i cookie consentiti se l'URL specificato non è attendibile; ovvero, se appartiene alla zona URLZONE_UNTRUSTED.

Valore

Significato

INTERNET_COOKIE_HTTPONLY

Abilita il recupero dei cookie contrassegnati come "HTTPOnly".

Non usare questo flag se si espone un'interfaccia scriptable, perché si tratta di implicazioni per la sicurezza. È imperativo usare questo flag solo se è possibile garantire che il cookie non venga mai esposto al codice di terze parti tramite un meccanismo di estendibilità fornito.

Versione: Richiede Internet Explorer 8.0 o versione successiva.

INTERNET_COOKIE_THIRD_PARTY

Recupera solo i cookie di terze parti se i criteri consentono esplicitamente a tutti i cookie di recuperare l'URL specificato.

INTERNET_FLAG_RESTRICTED_ZONE

Recupera solo i cookie consentiti se l'URL specificato non è attendibile; ovvero, se appartiene alla zona URLZONE_UNTRUSTED.

[in] lpReserved

Riservato per utilizzi futuri. Impostare su NULL.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce TRUE.

Se la funzione ha esito negativo, restituisce FALSE. Per ottenere un valore di errore specifico, chiamare GetLastError.

Se NULL viene passato a lpszCookieData, la chiamata avrà esito positivo e la funzione non verrà impostata ERROR_INSUFFICIENT_BUFFER.

I codici di errore seguenti possono essere impostati da questa funzione.

Codice restituito	Descrizione
ERROR_INSUFFICIENT_BUFFER	Restituito se i dati dei cookie recuperati sono maggiori delle dimensioni del buffer a cui punta il parametro pcchCookieData o se tale parametro è NULL.
ERROR_INVALID_PARAMETER	Restituito se il parametro pchURL o pcchCookieData è NULL.
ERROR_NO_MORE_ITEMS	Restituito se non sono stati recuperati dati cookied, come specificato.

Commenti

Nota WinINet non supporta le implementazioni del server. Inoltre, non deve essere usato da un servizio. Per le implementazioni o i servizi server usano Microsoft Windows HTTP Services (WinHTTP).

Nota

L'intestazione wininet.h definisce InternetGetCookieEx come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wininet.h
Libreria	Wininet.lib
DLL	Wininet.dll