WinHttpDetectAutoProxyConfigUrl 関数 (winhttp.h)

  • [アーティクル]

WinHttpDetectAutoProxyConfigUrl 関数は、プロキシ自動構成 (PAC) ファイルの URL を検索します。 この関数は PAC ファイルの URL を報告しますが、ファイルはダウンロードしません。

構文

WINHTTPAPI BOOL WinHttpDetectAutoProxyConfigUrl(
  [in]  DWORD  dwAutoDetectFlags,
  [out] LPWSTR *ppwstrAutoConfigUrl
);

パラメーター

[in] dwAutoDetectFlags

PAC ファイルの検索に使用するプロトコルを指定するデータ型。 DHCP と DNS 自動検出フラグの両方が設定されている場合は、最初に DHCP が使用されます。DHCP を使用して PAC URL が検出されない場合は、DNS が使用されます。

値 説明
WINHTTP_AUTO_DETECT_TYPE_DHCP
 DHCP を使用して、プロキシの自動構成ファイルを見つけます。
WINHTTP_AUTO_DETECT_TYPE_DNS_A
 DNS を使用して、ローカル コンピューターのドメイン上の既知の場所にプロキシの自動構成ファイルを検索します。

[out] ppwstrAutoConfigUrl

プロキシ データを受け取る構成 URL を含む null で終わる Unicode 文字列へのポインターを返すデータ型。 GlobalFree 関数を使用して、ppwszAutoConfigUrl が指す文字列を解放する必要があります。

戻り値

成功した場合は TRUE 、それ以外の場合 は FALSE を 返します。 拡張エラー情報については、 GetLastError を呼び出します。 返されるエラー コードは次のとおりです。

エラー コード 説明
ERROR_WINHTTP_AUTODETECTION_FAILED
 WinHTTP がプロキシ自動構成 (PAC) ファイルの URL を検出できなかった場合に返されます。
ERROR_WINHTTP_INTERNAL_ERROR
 内部エラーが発生しました。
ERROR_NOT_ENOUGH_MEMORY
 要求された操作を完了するのに十分なメモリが使用できませんでした。 (Windows エラー コード)

解説

WinHTTP では、 Web プロキシ自動検出 (WPAD) プロトコル (多くの場合、 autoproxy と呼ばれます) が実装されています。 既知の場所の詳細については、WPAD プロトコル ドキュメントの 探索プロセス に関するセクションを参照してください。

WinHttpDetectAutoProxyConfigUrl 関数は操作の完了に時間がかかるため、UI スレッドから呼び出さないでください。

要件

   
サポートされている最小のクライアント Windows XP、Windows 2000 Professional SP3 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003、Windows 2000 Server SP3 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winhttp.h
Library Winhttp.lib
[DLL] Winhttp.dll

関連項目

WinHTTP バージョン