Funzione InternetSetOptionW (wininet.h)

Articolo
03/04/2024

Imposta un'opzione Internet.

Sintassi

BOOL InternetSetOptionW(
  [in] HINTERNET hInternet,
  [in] DWORD     dwOption,
  [in] LPVOID    lpBuffer,
  [in] DWORD     dwBufferLength
);

Parametri

[in] hInternet

Gestire su cui impostare le informazioni.

[in] dwOption

Opzione Internet da impostare. Può trattarsi di uno dei valori di Flag di opzione .

[in] lpBuffer

Puntatore a un buffer contenente l'impostazione dell'opzione.

[in] dwBufferLength

Dimensioni del buffer lpBuffer . Se lpBuffer contiene una stringa, le dimensioni sono in TCHAR. Se lpBuffer contiene elementi diversi da una stringa, le dimensioni sono in byte.

Valore restituito

Restituisce TRUE se l'operazione riesce o FALSE in caso contrario. Per ottenere un messaggio di errore specifico, chiamare GetLastError.

Commenti

GetLastError restituirà l'errore ERROR_INVALID_PARAMETER se viene specificato un flag di opzione che non può essere impostato.

Per altre informazioni, vedere Impostazione e recupero di opzioni Internet.

Come tutti gli altri aspetti dell'API WinINet, questa funzione non può essere chiamata in modo sicuro da DllMain o dai costruttori e distruttori di oggetti globali.

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 i servizi HTTP di Microsoft Windows (WinHTTP).

Nota

L'intestazione wininet.h definisce InternetSetOption 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

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