InternetGetProxyInfo 函式

重要

此函式在Windows 10已被取代，而且自 Windows 11 起不受支援。 針對 autoproxy 支援，請改用 HTTP 服務 (WinHTTP) 5.1 版。 如需詳細資訊，請參閱 WinHTTP AutoProxy 支援。

擷取 Proxy 資料以存取指定的資源。 此函式只能藉由明確載入 JSProxy.dll 來呼叫。

語法

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

參數

lpszUrl [in]

指定目標 HTTP 資源 URL 之 Null 終止字串的指標。

dwUrlLength [in]

lpszUrl所指向之 URL 的大小，以位元組為單位。

lpszUrlHostName [in]

指定目標 URL 主機名稱之 Null 終止字串的指標。

dwUrlHostNameLength [in]

lpszUrlHostName所指向主機名稱的大小，以位元組為單位。

lplpszProxyHostName [out]

緩衝區位址的指標，接收要用於指定資源的 HTTP 要求中之 Proxy 的 URL。 應用程式負責釋放此字串。

lpdwProxyHostNameLength [out]

接收 lplpszProxyHostName 緩衝區中傳回之字串大小位元組之變數的指標。

傳回值

如果成功，則傳回 TRUE ，否則傳回 FALSE 。 若要取得擴充的錯誤資料，請呼叫 GetLastError。

備註

若要呼叫 InternetGetProxyInfo，您必須使用定義的函式指標類型 pfnInternetGetProxyInfo動態連結至它。 下列程式碼片段示範如何宣告此函式指標類型的實例，然後初始化並呼叫它。

  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.

如同 WinINet API 的所有其他層面，此函式無法安全地從 DllMain 或全域物件的建構函式和解構函式呼叫。

注意

WinINet 不支援伺服器實作。 此外，它不應該從服務使用。 對於伺服器實作或服務，請使用 Microsoft Windows HTTP 服務 (WinHTTP) 。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式] 自 Windows 11 起不支援
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
DLL	JSProxy.dll

另請參閱

• InternetInitializeAutoProxyDll
• InternetDeInitializeAutoProxyDll
• DetectAutoProxyUrl