Funzione InternetQueryOptionA (wininet.h)

Articolo
03/04/2024

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

Sintassi

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

Parametri

[in] hInternet

Gestire le informazioni su cui eseguire query.

[in] dwOption

Opzione Internet da eseguire query. Questo può essere 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, quindi l'applicazione chiamante deve liberarli al termine dell'uso.

[in, out] lpdwBufferLength

Puntatore a una variabile contenente le dimensioni di lpBuffer, in byte. Quando InternetQueryOption restituisce, 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 ha esito positivo o FALSE in caso contrario. Per ottenere un messaggio di errore specifico, chiamare GetLastError.

Commenti

GetLastError restituirà il ERROR_INVALID_PARAMETER se un flag di opzione non valido per il tipo di handle specificato viene passato al parametro dwOption .

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

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