Funzione InternetSetOptionA (wininet.h)

Articolo
08/27/2023

Imposta un'opzione Internet.

Sintassi

BOOL InternetSetOptionA(
  [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. Questo può essere 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, la dimensione è in TCHARs. Se lpBuffer contiene qualsiasi elemento diverso da una stringa, la dimensione è in byte.

Valore restituito

Restituisce TRUE se ha esito positivo 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 dall'interno di DllMain o dai costruttori e distruttori degli oggetti globali.

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