InternetQueryOptionW-Funktion (wininet.h)
Fragt eine Internetoption für das angegebene Handle ab.
Syntax
BOOL InternetQueryOptionW(
[in] HINTERNET hInternet,
[in] DWORD dwOption,
[out] LPVOID lpBuffer,
[in, out] LPDWORD lpdwBufferLength
);
Parameter
[in] hInternet
Behandeln Sie, für die Informationen abgefragt werden sollen.
[in] dwOption
Internetoption, die abgefragt werden soll. Dies kann einer der Option Flags-Werte sein.
[out] lpBuffer
Zeiger auf einen Puffer, der die Optionseinstellung empfängt. Von InternetQueryOption zurückgegebene Zeichenfolgen werden global zugeordnet, sodass die aufrufende Anwendung sie freigeben muss, wenn sie mit der Verwendung abgeschlossen ist.
[in, out] lpdwBufferLength
Zeiger auf eine Variable, die die Größe von lpBuffer in Bytes enthält. Wenn InternetQueryOption zurückgibt, gibt lpdwBufferLength die Größe der in lpBuffer platzierten Daten an. Wenn GetLastError ERROR_INSUFFICIENT_BUFFER zurückgibt, verweist dieser Parameter auf die Anzahl der Bytes, die zum Aufnehmen der angeforderten Informationen erforderlich sind.
Rückgabewert
Gibt TRUE zurück, wenn der Vorgang erfolgreich war, oder andernfalls FALSE . Rufen Sie GetLastError auf, um eine bestimmte Fehlermeldung zu erhalten.
Hinweise
GetLastError gibt den ERROR_INVALID_PARAMETER zurück, wenn ein Optionsflag, das für den angegebenen Handle-Typ ungültig ist, an den dwOption-Parameter übergeben wird.
Weitere Informationen finden Sie unter
Festlegen und Abrufen von Internetoptionen.
Wie alle anderen Aspekte der WinINet-API kann diese Funktion nicht sicher innerhalb von DllMain oder den Konstruktoren und Destruktoren globaler Objekte aufgerufen werden.
Hinweis
Der wininet.h-Header definiert InternetQueryOption als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | wininet.h |
Bibliothek | Wininet.lib |
DLL | Wininet.dll |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für