Compartir a través de

Función InternetGetProxyInfo

  • Artículo

Importante

Esta función está en desuso en Windows 10 y no se admite a partir de Windows 11. Para la compatibilidad con autoproxy, use la versión 5.1 de servicios HTTP (WinHTTP) en su lugar. Para obtener más información, consulte Compatibilidad con WinHTTP AutoProxy.

Recupera datos de proxy para acceder a los recursos especificados. Solo se puede llamar a esta función cargando JSProxy.dllexplícitamente .

Sintaxis

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

Parámetros

lpszUrl [in]

Puntero a una cadena terminada en null que especifica la dirección URL del recurso HTTP de destino.

dwUrlLength [in]

Tamaño, en bytes, de la dirección URL a la que apunta lpszUrl.

lpszUrlHostName [in]

Puntero a una cadena terminada en null que especifica el nombre de host de la dirección URL de destino.

dwUrlHostNameLength [in]

Tamaño, en bytes, del nombre de host al que apunta lpszUrlHostName.

lplpszProxyHostName [out]

Puntero a la dirección de un búfer que recibe la dirección URL del proxy que se va a usar en una solicitud HTTP para el recurso especificado. La aplicación es responsable de liberar esta cadena.

lpdwProxyHostNameLength [out]

Puntero a una variable que recibe el tamaño, en bytes, de la cadena devuelta en el búfer lplpszProxyHostName .

Valor devuelto

Devuelve TRUE si se ejecuta correctamente o FALSE de lo contrario. Para obtener datos de error extendidos, llame a GetLastError.

Comentarios

Para llamar a InternetGetProxyInfo, debe vincularla dinámicamente mediante el tipo de puntero de función definido pfnInternetGetProxyInfo. En el fragmento de código siguiente se muestra cómo declarar una instancia de este tipo de puntero de función y, a continuación, inicializarla y llamarla.

  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.

Al igual que todos los demás aspectos de la API de WinINet, esta función no se puede llamar de forma segura desde DllMain ni desde los constructores y destructores de objetos globales.

Nota

WinINet no admite implementaciones de servidor. Además, no se debe usar desde un servicio. En el caso de las implementaciones de servidor o los servicios, use los servicios HTTP de Microsoft Windows (WinHTTP).

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows 2000 Professional [solo aplicaciones de escritorio]
No admitido a partir de Windows 11
Servidor mínimo compatible
 Windows 2000 Server [solo aplicaciones de escritorio]
Archivo DLL
JSProxy.dll

Consulte también