InternetGetProxyInfo-Funktion

Wichtig

Diese Funktion ist für Windows 10 veraltet und wird ab Windows 11 nicht mehr unterstützt. Verwenden Sie stattdessen http Services (WinHTTP) Version 5.1, um Unterstützung für autoproxy zu erhalten. Weitere Informationen finden Sie unter WinHTTP AutoProxy-Unterstützung.

Ruft Proxydaten für den Zugriff auf angegebene Ressourcen ab. Diese Funktion kann nur aufgerufen werden, indem explizit geladen JSProxy.dll wird.

Syntax

BOOL InternetGetProxyInfo(
  _In_  LPCSTR  lpszUrl,
  _In_  DWORD   dwUrlLength,
  _In_  LPSTR   lpszUrlHostName,
  _In_  DWORD   dwUrlHostNameLength,
  _Out_ LPSTR   *lplpszProxyHostName,
  _Out_ LPDWORD lpdwProxyHostNameLength
);

Parameter

lpszUrl [ In]

Ein Zeiger auf eine auf NULL endende Zeichenfolge, die die URL der HTTP-Zielressource angibt.

dwUrlLength [ In]

Die Größe der URL, auf die lpszUrl zeigt, in Bytes.

lpszUrlHostName [ In]

Ein Zeiger auf eine auf NULL endende Zeichenfolge, die den Hostnamen der Ziel-URL angibt.

dwUrlHostNameLength [ In]

Die Größe des Hostnamens in Bytes, auf den lpszUrlHostName zeigt.

lplpszProxyHostName [ out]

Ein Zeiger auf die Adresse eines Puffers, der die URL des Proxys empfängt, der in einer HTTP-Anforderung für die angegebene Ressource verwendet werden soll. Die Anwendung ist für das Freigeben dieser Zeichenfolge verantwortlich.

lpdwProxyHostNameLength [ out]

Ein Zeiger auf eine Variable, die die Größe der im lplpszProxyHostName-Puffer zurückgegebenen Zeichenfolge in Bytes empfängt.

Rückgabewert

Gibt TRUE zurück, wenn erfolgreich, andernfalls FALSE. Rufen Sie GetLastErrorauf, um erweiterte Fehlerdaten abzurufen.

Hinweise

Um InternetGetProxyInfo aufzurufen, müssen Sie mithilfe des definierten Funktionszeigertyps pfnInternetGetProxyInfo dynamisch eine Verknüpfung damit herstellen. Der folgende Codeausschnitt zeigt, wie Sie eine Instanz dieses Funktionszeigertyps deklarieren und anschließend initialisieren und aufrufen.

  HMODULE hModJS;                               // Handle for loading the DLL
  pfnInternetGetProxyInfo pIGPI;                // Function-pointer instance

  hModJS = LoadLibrary( TEXT("jsproxy.dll") );
  if (!hModJS)
  {
    _tprintf( TEXT("\nLoadLibrary failed to load jsproxy.dll with error: %d\n"),
            GetLastError( ) );
    return( FALSE );
  }

  pIGPI = (pfnInternetGetProxyInfo)
          GetProcAddress( hModJS, "InternetGetProxyInfo" );
  if (!pIGPI)         
  {
    _tprintf( TEXT("\nGetProcAddress failed to find InternetGetProxyInfo, error: %d\n"),
            GetLastError( ) );
    return( FALSE );
  }

  // The pIGPI function pointer can now be used to call InternetGetProxyInfo.

Wie alle anderen Aspekte der WinINet-API kann diese Funktion nicht sicher über DllMain oder die Konstruktoren und Destruktoren globaler Objekte aufgerufen werden.

Hinweis

WinINet unterstützt keine Serverimplementierungen. Darüber hinaus sollte sie nicht von einem Dienst verwendet werden. Verwenden Sie für Serverimplementierungen oder -dienste Microsoft Windows HTTP-Dienste (WinHTTP).

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Ab Windows 11 nicht unterstützt
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
DLL
JSProxy.dll

Siehe auch