Funzione InternetGetCookieExW (wininet.h)

Articolo
11/20/2024

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 di cookie o, per criterio, associati a siti non attendibili o cookie di terze parti.

Sintassi

BOOL InternetGetCookieExW(
  [in]                LPCWSTR lpszUrl,
  [in]                LPCWSTR lpszCookieName,
  [in, out, optional] LPWSTR  lpszCookieData,
  [in, out]           LPDWORD lpdwSize,
  [in]                DWORD   dwFlags,
  [in]                LPVOID  lpReserved
);

Parametri

[in] lpszUrl

Puntatore a un nullstringa con terminazione contenente l'URL a cui è associato il cookie da recuperare. Questo parametro non può essere NULL o InternetGetCookieEx ha esito negativo e restituisce un errore di ERROR_INVALID_PARAMETER.

[in] lpszCookieName

Puntatore a un nullstringa con terminazione contenente il nome del cookie da recuperare. Questo nome fa distinzione tra maiuscole e minuscole.

[in, out, optional] lpszCookieData

Puntatore a un buffer per ricevere i dati del cookie.

[in, out] lpdwSize

Puntatore a una variabile DWORD.

In caso di immissione, la variabile deve contenere le dimensioni, in TCHAR, del buffer a cui punta il parametro pchCookieData.

All'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 oppure 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 ha esito negativo 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ò essere 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 scriptabile, perché ciò ha implicazioni per la sicurezza. È fondamentale 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 il recupero di tutti i cookie per l'URL specificato.
INTERNET_FLAG_RESTRICTED_ZONE	Recupera solo i cookie che sarebbero consentiti se l'URL specificato non fosse 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 scriptabile, perché ciò ha implicazioni per la sicurezza. È fondamentale 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 il recupero di tutti i cookie per l'URL specificato.

INTERNET_FLAG_RESTRICTED_ZONE

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

[in] lpReserved

Riservato per uso futuro. Impostare su NULL.

Valore restituito

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

Se la funzione non riesce, 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 imposta 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 è possibile recuperare dati con cookie come specificato.

Osservazioni

Nota WinINet non supporta le implementazioni del server. Inoltre, non deve essere usato da un servizio. Per le implementazioni del server o i servizi, usare Servizi HTTP Di Microsoft Windows (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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	wininet.h
libreria	Wininet.lib
dll	Wininet.dll