InternetGetProxyInfo, fonction
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.dll
explicitement .
BOOL InternetGetProxyInfo(
_In_ LPCSTR lpszUrl,
_In_ DWORD dwUrlLength,
_In_ LPSTR lpszUrlHostName,
_In_ DWORD dwUrlHostNameLength,
_Out_ LPSTR *lplpszProxyHostName,
_Out_ LPDWORD lpdwProxyHostNameLength
);
-
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 .
Retourne TRUE en cas de réussite, ou FALSE dans le cas contraire. Pour obtenir des données d’erreur étendues, appelez GetLastError.
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).
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 |
|