Funzione InternetSetCookieExA (wininet.h)

Articolo
11/20/2024

La funzione internetSetCookieEx crea un cookie con un nome specificato associato a un URL specificato. Questa funzione è diversa dalla funzione InternetSetCookie tramite la possibilità 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 un nullstringa con terminazione 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 un nullstringa con terminazione contenente il nome da associare a questo cookie. Se questo puntatore è NULL, non viene associato alcun nome al cookie.

[in] lpszCookieData

Puntatore a un nullstringa con terminazione 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

Flag che controllano 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 a un 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 scriptabile, perché ciò ha implicazioni per la sicurezza. Se si espone un'interfaccia scriptabile, è possibile diventare un vettore di attacco per gli attacchi di scripting tra siti. È assolutamente imperativo usare questo flag solo se possono garantire che non si consentirà mai al codice di terze parti di 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

NULLo 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, memoria di sistema insufficiente era disponibile.

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