WinHttpConnect 関数 (winhttp.h)
構文
WINHTTPAPI HINTERNET WinHttpConnect(
[in] HINTERNET hSession,
[in] LPCWSTR pswzServerName,
[in] INTERNET_PORT nServerPort,
[in] DWORD dwReserved
);
パラメーター
[in] hSession
有効な
[in] pswzServerName
HTTP サーバーのホスト名を含む null-terminated 文字列へのポインター。 または、10.0.1.45 などの文字列として、サイトの IP アドレスを文字列として含めることができます。
WinHttp は、最初に Punycodeに変換せずに国際ホスト名
[in] nServerPort
接続先のサーバー上の TCP/IP ポートを指定する符号なし整数。 このパラメーターには、任意の有効な TCP/IP ポート番号、または次のいずれかの値を指定できます。
[in] dwReserved
このパラメーターは予約済みであり、0 である必要があります。
戻り値
接続に成功した場合は HTTP セッションへの有効な接続ハンドルを返します。それ以外の場合は NULL
| エラー コード | 形容 |
|---|---|
|
指定されたハンドルの種類がこの操作に対して正しくありません。 |
|
内部エラーが発生しました。 |
|
URL が無効です。 |
|
通常、操作は取り消されました。これは、操作が完了する前に要求が操作されていたハンドルが閉じられたためです。 |
|
URL スキームを認識できなかったか、サポートされていません。 |
|
WinHTTP 関数のサポートがシャットダウンまたはアンロードされています。 |
|
要求された操作を完了するのに十分なメモリが使用できませんでした。 (Windows エラー コード) |
備考
WinHTTP が非同期モードで使用されている場合 (つまり、WinHttpOpenで
呼び出し元のアプリケーションが WinHttpConnectによって返される
WinHttpConnect はターゲット HTTP サーバーを指定しますが、要求がリダイレクトされた場合、応答は別のサーバーから送信される可能性があります。 WINHTTP_OPTION_URL フラグを指定して WinHttpQueryOption
例
次の例は、セキュリティで保護されたトランザクション セマンティクスを使用して、HTTPS サーバーからリソースをダウンロードする方法を示しています。 サンプル コードでは、Microsoft Windows HTTP Services (WinHTTP) アプリケーション プログラミング インターフェイス (API) を初期化し、ターゲット HTTPS サーバーを選択してから、このセキュリティで保護されたリソースの要求を開いて送信します。
要求ハンドル
DWORD dwSize = 0;
DWORD dwDownloaded = 0;
LPSTR pszOutBuffer;
BOOL bResults = FALSE;
HINTERNET hSession = NULL,
hConnect = NULL,
hRequest = NULL;
// Use WinHttpOpen to obtain a session handle.
hSession = WinHttpOpen( L"WinHTTP Example/1.0",
WINHTTP_ACCESS_TYPE_DEFAULT_PROXY,
WINHTTP_NO_PROXY_NAME,
WINHTTP_NO_PROXY_BYPASS, 0);
// Specify an HTTP server.
if (hSession)
hConnect = WinHttpConnect( hSession, L"www.microsoft.com",
INTERNET_DEFAULT_HTTPS_PORT, 0);
// Create an HTTP request handle.
if (hConnect)
hRequest = WinHttpOpenRequest( hConnect, L"GET", NULL,
NULL, WINHTTP_NO_REFERER,
WINHTTP_DEFAULT_ACCEPT_TYPES,
WINHTTP_FLAG_SECURE);
// Send a request.
if (hRequest)
bResults = WinHttpSendRequest( hRequest,
WINHTTP_NO_ADDITIONAL_HEADERS,
0, WINHTTP_NO_REQUEST_DATA, 0,
0, 0);
// End the request.
if (bResults)
bResults = WinHttpReceiveResponse( hRequest, NULL);
// Keep checking for data until there is nothing left.
if (bResults)
do
{
// Check for available data.
dwSize = 0;
if (!WinHttpQueryDataAvailable( hRequest, &dwSize))
printf("Error %u in WinHttpQueryDataAvailable.\n", GetLastError());
// Allocate space for the buffer.
pszOutBuffer = new char[dwSize+1];
if (!pszOutBuffer)
{
printf("Out of memory\n");
dwSize=0;
}
else
{
// Read the Data.
ZeroMemory(pszOutBuffer, dwSize+1);
if (!WinHttpReadData( hRequest, (LPVOID)pszOutBuffer,
dwSize, &dwDownloaded))
printf( "Error %u in WinHttpReadData.\n", GetLastError());
else
printf( "%s\n", pszOutBuffer);
// Free the memory allocated to the buffer.
delete [] pszOutBuffer;
}
} while (dwSize > 0);
// Report any errors.
if (!bResults)
printf("Error %d has occurred.\n", GetLastError());
// Close any open handles.
if (hRequest) WinHttpCloseHandle(hRequest);
if (hConnect) WinHttpCloseHandle(hConnect);
if (hSession) WinHttpCloseHandle(hSession);
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows XP、Windows 2000 Professional SP3 [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows Server 2003、Windows 2000 Server SP3 [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | winhttp.h |
| ライブラリ | Winhttp.lib |
| DLL | Winhttp.dll |
| 再頒布可能パッケージの | Windows XP および Windows 2000 の WinHTTP 5.0 および Internet Explorer 5.01 以降。 |
関連項目
Microsoft Windows HTTP Services (WinHTTP) について
WinHttpOpenRequest の