Funzione InternetSetCookieExA (wininet.h)

Articolo
08/27/2023

La funzione InternetSetCookieEx crea un cookie con un nome specificato associato a un URL specificato. Questa funzione differisce dalla funzione InternetSetCookie in grado di creare cookie di terze parti.

Sintassi

DWORD InternetSetCookieExA(
  [in] LPCSTR    lpszUrl,
  [in] LPCSTR    lpszCookieName,
  [in] LPCSTR    lpszCookieData,
  [in] DWORD     dwFlags,
  [in] DWORD_PTR dwReserved
);

Parametri

[in] lpszUrl

Puntatore a una stringa con terminazione null contenente l'URL per cui deve essere impostato il cookie.

Se questo puntatore è NULL, InternetSetCookieEx ha esito negativo con un errore di ERROR_INVALID_PARAMETER .

[in] lpszCookieName

Puntatore a una stringa con terminazione null contenente il nome da associare a questo cookie. Se questo puntatore è NULL, non viene associato alcun nome al cookie.

[in] lpszCookieData

Puntatore a una stringa con terminazione null contenente i dati da associare al nuovo cookie.

Se questo puntatore è NULL, InternetSetCookieEx ha esito negativo con un errore di ERROR_INVALID_PARAMETER .

[in] dwFlags

Contrassegna il modo in cui la funzione recupera i dati dei cookie:

Valore	Significato
INTERNET_COOKIE_EVALUATE_P3P	Se questo flag è impostato e il parametro dwReserved non è NULL, il parametro dwReserved viene eseguito il cast in un'intestazione LPCTSTR che punta a un'intestazione Platform-for-Privacy-Protection (P3P) per il cookie in questione.
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. Se si espone un'interfaccia scriptable, è possibile diventare un vettore di attacco per attacchi di script cross-site. È assolutamente imperativo usare questo flag solo se possono garantire che il codice di terze parti non possa mai impostare un cookie usando questo flag tramite un meccanismo di estendibilità fornito. Versione: Richiede Internet Explorer 8.0 o versione successiva.
INTERNET_COOKIE_THIRD_PARTY	Indica che il cookie impostato è un cookie di terze parti.
INTERNET_FLAG_RESTRICTED_ZONE	Indica che il cookie impostato è associato a un sito non attendibile.

[in] dwReserved

NULL o contiene un puntatore a un'intestazione Platform-for-Privacy-Protection (P3P) da associare al cookie.

Valore restituito

Restituisce un membro dell'enumerazione InternetCookieState se ha esito positivo o FALSE se la funzione ha esito negativo. In caso di errore, se una chiamata a GetLastError restituisce ERROR_NOT_ENOUGH_MEMORY, era disponibile memoria di sistema insufficiente.

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 InternetSetCookieEx 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


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