InternetGetProxyInfo 函式

擷取 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 或全域物件的建構函式和解構函式呼叫。

規格需求

另請參閱

• InternetInitializeAutoProxyDll
• InternetDeInitializeAutoProxyDll
• DetectAutoProxyUrl