InternetGetProxyInfo 関数

指定したリソースにアクセスするためのプロキシ データを取得します。 この関数は、 を明示的に読み込むことで 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 要求で使用するプロキシの URL を受け取るバッファーのアドレスへのポインター。 アプリケーションは、この文字列を解放する役割を担います。

lpdwProxyHostNameLength [out]

lplpszProxyHostName バッファーで返される文字列のサイズ (バイト単位) を受け取る変数へのポインター。

戻り値

成功した場合は TRUE 、それ以外の場合 は FALSE を 返します。 拡張エラー データを取得するには、 GetLastError を呼び出します。

解説

InternetGetProxyInfo を呼び出すには、定義された関数ポインター型 pfnInternetGetProxyInfo を使用して、InternetGetProxyInfo に動的にリンクする必要があります。 次のコード スニペットは、この関数ポインター型のインスタンスを宣言し、初期化して呼び出す方法を示しています。

  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