Freigeben über

InternetGetProxyInfo-Funktion

  • Artikel

Wichtig

Diese Funktion ist auf Windows 10 veraltet und wird ab Windows 11 nicht mehr unterstützt. Verwenden Sie für autoproxy-Unterstützung stattdessen HTTP Services (WinHTTP) Version 5.1. 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.dllwird.

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 NULL-endende Zeichenfolge, die die URL der HTTP-Zielressource angibt.

dwUrlLength [in]

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

lpszUrlHostName [in]

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

dwUrlHostNameLength [in]

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

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 Puffer lplpszProxyHostName zurückgegebenen Zeichenfolge in Bytes empfängt.

Rückgabewert

Gibt TRUE zurück, wenn erfolgreich, andernfalls FALSE . Rufen Sie GetLastError auf, um erweiterte Fehlerdaten zu erhalten.

Bemerkungen

Um InternetGetProxyInfo aufzurufen, müssen Sie eine dynamische Verknüpfung mit dem definierten Funktionszeigertyp pfnInternetGetProxyInfo herstellen. Der folgende Codeausschnitt zeigt, wie Sie eine instance dieses Funktionszeigertyps deklarieren und dann 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 aus DllMain oder den Konstruktoren und Destruktoren globaler Objekte aufgerufen werden.

Hinweis

WinINet unterstützt keine Serverimplementierungen. Darüber hinaus sollte es nicht von einem Dienst verwendet werden. Verwenden Sie für Serverimplementierungen oder Dienste Microsoft Windows HTTP Services (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

Weitere Informationen