Funzione InternetQueryOptionW (wininet.h)

Articolo
03/04/2024

Esegue una query su un'opzione Internet sull'handle specificato.

Sintassi

BOOL InternetQueryOptionW(
  [in]      HINTERNET hInternet,
  [in]      DWORD     dwOption,
  [out]     LPVOID    lpBuffer,
  [in, out] LPDWORD   lpdwBufferLength
);

Parametri

[in] hInternet

Gestire su cui eseguire query sulle informazioni.

[in] dwOption

Opzione Internet su cui eseguire query. Può trattarsi di uno dei valori di Flag di opzione .

[out] lpBuffer

Puntatore a un buffer che riceve l'impostazione dell'opzione. Le stringhe restituite da InternetQueryOption vengono allocate a livello globale, pertanto l'applicazione chiamante deve liberarle al termine dell'uso.

[in, out] lpdwBufferLength

Puntatore a una variabile che contiene le dimensioni di lpBuffer, in byte. Quando InternetQueryOption viene restituito, lpdwBufferLength specifica le dimensioni dei dati inseriti in lpBuffer. Se GetLastError restituisce ERROR_INSUFFICIENT_BUFFER, questo parametro punta al numero di byte necessari per contenere le informazioni richieste.

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à il ERROR_INVALID_PARAMETER se al parametro dwOption viene passato un flag di opzione non valido per il tipo di handle specificato.

Per ulteriori 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 InternetQueryOption 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