InternetGetProxyInfo, fonction

  • Article

Important

Cette fonction est déconseillée sur Windows 10 et n’est pas prise en charge à partir de Windows 11. Pour la prise en charge d’autoproxy, utilisez les services HTTP (WinHTTP) version 5.1 à la place. Pour plus d’informations, consultez Prise en charge de WinHTTP AutoProxy.

Récupère les données de proxy pour accéder aux ressources spécifiées. Cette fonction ne peut être appelée qu’en chargeant JSProxy.dllexplicitement .

Syntaxe

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

Paramètres

lpszUrl [in]

Pointeur vers une chaîne terminée par null qui spécifie l’URL de la ressource HTTP cible.

dwUrlLength [in]

Taille, en octets, de l’URL pointée par lpszUrl.

lpszUrlHostName [in]

Pointeur vers une chaîne terminée par null qui spécifie le nom d’hôte de l’URL cible.

dwUrlHostNameLength [in]

Taille, en octets, du nom d’hôte pointé par lpszUrlHostName.

lplpszProxyHostName [out]

Pointeur vers l’adresse d’une mémoire tampon qui reçoit l’URL du proxy à utiliser dans une requête HTTP pour la ressource spécifiée. L’application est chargée de libérer cette chaîne.

lpdwProxyHostNameLength [out]

Pointeur vers une variable qui reçoit la taille, en octets, de la chaîne retournée dans la mémoire tampon lplpszProxyHostName .

Valeur retournée

Retourne TRUE en cas de réussite, ou FALSE dans le cas contraire. Pour obtenir des données d’erreur étendues, appelez GetLastError.

Notes

Pour appeler InternetGetProxyInfo, vous devez y établir une liaison dynamique à l’aide du type de pointeur de fonction défini pfnInternetGetProxyInfo. L’extrait de code ci-dessous montre comment déclarer un instance de ce type de pointeur de fonction, puis l’initialiser et l’appeler.

  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.

Comme tous les autres aspects de l’API WinINet, cette fonction ne peut pas être appelée en toute sécurité à partir de DllMain ou des constructeurs et destructeurs d’objets globaux.

Notes

WinINet ne prend pas en charge les implémentations de serveur. En outre, il ne doit pas être utilisé à partir d’un service. Pour les implémentations de serveur ou les services, utilisez Microsoft Windows HTTP Services (WinHTTP).

Spécifications

Condition requise Valeur
Client minimal pris en charge
 Windows 2000 Professionnel [applications de bureau uniquement]
Non pris en charge à partir de Windows 11
Serveur minimal pris en charge
 Windows 2000 Server [applications de bureau uniquement]
DLL
JSProxy.dll

Voir aussi