Função InternetGetProxyInfo

  • Artigo

Importante

Essa função é preterida em Windows 10 e não tem suporte a partir de Windows 11. Para obter suporte a autoproxia, use os Serviços HTTP (WinHTTP) versão 5.1. Para obter mais informações, consulte Suporte a AutoProxy do WinHTTP.

Recupera dados de proxy para acessar recursos especificados. Essa função só pode ser chamada carregando JSProxy.dllexplicitamente .

Sintaxe

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

Parâmetros

lpszUrl [in]

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica a URL do recurso HTTP de destino.

dwUrlLength [in]

O tamanho, em bytes, da URL apontada por lpszUrl.

lpszUrlHostName [in]

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do host da URL de destino.

dwUrlHostNameLength [in]

O tamanho, em bytes, do nome do host apontado por lpszUrlHostName.

lplpszProxyHostName [out]

Um ponteiro para o endereço de um buffer que recebe a URL do proxy a ser usada em uma solicitação HTTP para o recurso especificado. O aplicativo é responsável por liberar essa cadeia de caracteres.

lpdwProxyHostNameLength [out]

Um ponteiro para uma variável que recebe o tamanho, em bytes, da cadeia de caracteres retornada no buffer lplpszProxyHostName .

Valor retornado

Retorna TRUE se tiver êxito ou FALSE caso contrário. Para obter dados de erro estendidos, chame GetLastError.

Comentários

Para chamar InternetGetProxyInfo, você deve vincular dinamicamente a ele usando o tipo de ponteiro de função definido pfnInternetGetProxyInfo. O snippet de código abaixo mostra como declarar uma instância desse tipo de ponteiro de função e, em seguida, inicializá-la e chamá-la.

  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.

Como todos os outros aspectos da API WinINet, essa função não pode ser chamada com segurança de dentro do DllMain ou dos construtores e destruidores de objetos globais.

Observação

O WinINet não dá suporte a implementações de servidor. Além disso, ele não deve ser usado de um serviço. Para implementações ou serviços de servidor, use Os Serviços HTTP do Microsoft Windows (WinHTTP).

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows 2000 Professional [somente aplicativos da área de trabalho]
Sem suporte a partir de Windows 11
Servidor mínimo com suporte
 Windows 2000 Server [somente aplicativos da área de trabalho]
DLL
JSProxy.dll

Confira também