InternetGetProxyInfo 関数
重要
この関数は、Windows 10では非推奨であり、Windows 11の時点ではサポートされていません。 autoproxy サポートの場合は、代わりに HTTP サービス (WinHTTP) バージョン 5.1 を使用してください。 詳細については、「 WinHTTP AutoProxy のサポート」を参照してください。
指定したリソースにアクセスするためのプロキシ データを取得します。 この関数は、 を明示的に読み込むことで 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 またはグローバル オブジェクトのコンストラクターとデストラクター内から安全に呼び出すことはできません。
Note
WinINet では、サーバーの実装はサポートされていません。 また、サービスから使用しないでください。 サーバーの実装またはサービスの場合は、 Microsoft Windows HTTP サービス (WinHTTP) を使用します。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] Windows 11時点ではサポートされていません |
| サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
| [DLL] |
|