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