WinHttpWriteData 함수(winhttp.h)
WinHttpWriteData 함수는 요청 데이터를 HTTP 서버에 씁니다.
구문
WINHTTPAPI BOOL WinHttpWriteData(
[in] HINTERNET hRequest,
[in] LPCVOID lpBuffer,
[in] DWORD dwNumberOfBytesToWrite,
[out] LPDWORD lpdwNumberOfBytesWritten
);
매개 변수
[in] hRequest
WinHttpOpenRequest에서 반환된 유효한 HINTERNET 핸들입니다. 이 함수를 호출하기 전에 WinHttpSendRequest 가 완료될 때까지 기다립니다.
[in] lpBuffer
서버로 보낼 데이터가 포함된 버퍼에 대한 포인터입니다. WinHttpWriteData가 완료될 때까지 이 버퍼가 유효한지 확인합니다.
[in] dwNumberOfBytesToWrite
파일에 쓸 바이트 수를 포함하는 부호 없는 long 정수 값입니다.
[out] lpdwNumberOfBytesWritten
버퍼에 기록된 바이트 수를 수신하는 부호 없는 long 정수 변수에 대한 포인터입니다. WinHttpWriteData 함수는 작업 또는 오류 검사를 수행하기 전에 이 값을 0으로 설정합니다. WinHTTP를 비동기적으로 사용하는 경우 이 매개 변수를 NULL 로 설정하고 콜백 함수에서 정보를 검색해야 합니다. 이렇게 하지 않을 경우 메모리 오류가 발생할 수 있습니다.
반환 값
성공하면 TRUE를 반환하고 그렇지 않으면 FALSE를 반환합니다. 확장된 오류 정보는 GetLastError를 호출합니다. 반환된 오류 코드 중에는 다음이 있습니다.
| 오류 코드 | Description |
|---|---|
|
서버와의 연결이 다시 설정되거나 종료되었거나 호환되지 않는 SSL 프로토콜이 발견되었습니다. 예를 들어 WinHTTP 버전 5.1은 클라이언트가 특별히 사용하도록 설정하지 않는 한 SSL2를 지원하지 않습니다. |
|
제공된 핸들이 올바른 상태가 아니므로 요청된 작업을 수행할 수 없습니다. |
|
이 작업에 대해 제공된 핸들의 형식이 올바르지 않습니다. |
|
내부 오류가 발생했습니다. |
|
작업이 완료되기 전에 요청이 작동 중인 핸들이 닫혔기 때문에 작업이 취소되었습니다. |
|
요청 시간이 초과되었습니다. |
|
메모리가 부족하여 요청된 작업을 완료할 수 없습니다. (Windows 오류 코드) |
설명
WinHTTP가 비동기 모드에서 사용되는 경우에도(즉, WinHttpOpen에서 WINHTTP_FLAG_ASYNC 설정된 경우) 이 함수는 동기적으로 또는 비동기적으로 작동할 수 있습니다. 이 함수가 FALSE를 반환하는 경우 GetLastError 를 호출하여 확장된 오류 정보를 가져올 수 있습니다. 이 함수가 TRUE를 반환하는 경우 WINHTTP_CALLBACK_STATUS_WRITE_COMPLETE 완료를 사용하여 이 함수가 성공했는지 여부와 매개 변수 값을 확인합니다. WINHTTP_CALLBACK_STATUS_REQUEST_ERROR 완료는 작업이 비동기적으로 완료되었지만 실패했음을 나타냅니다.
winHttpSetStatusCallback과 함께 상태 콜백 함수가 설치된 경우 WinHttpSetStatusCallback의 dwNotificationFlags 매개 변수에 설정된 다음 알림 중에서 서버에 데이터를 보내는 진행 상황을 나타냅니다.
- WINHTTP_CALLBACK_STATUS_RECEIVING_RESPONSE
- WINHTTP_CALLBACK_STATUS_RESPONSE_RECEIVED
- WINHTTP_CALLBACK_STATUS_DATA_WRITTEN
- WINHTTP_CALLBACK_STATUS_SENDING_REQUEST
- WINHTTP_CALLBACK_STATUS_REQUEST_SENT
- WINHTTP_CALLBACK_STATUS_WRITE_COMPLETE
둘째, NTLM 및 협상은 인증을 완료하기 위해 여러 핸드셰이크가 필요할 수 있으며, 각 인증 다리에 대해 데이터를 다시 POST'로 설정해야 합니다. 이는 대용량 데이터 업로드에 매우 비효율적일 수 있습니다.
이러한 두 문제를 해결하기 위해 한 가지 해결 방법은 먼저 인증 v-dir에 HEAD 같은 멱등성 준비 요청을 보내고, 이 요청과 관련된 인증 챌린지를 처리한 다음 POST 데이터만 처리하는 것입니다. POST'ing을 처리하는 데 동일한 소켓을 다시 사용하는 한 추가 인증 문제가 발생하지 않아야 하며 모든 데이터를 한 번에 업로드할 수 있습니다. 인증된 소켓은 동일한 세션 내의 후속 요청에만 재사용할 수 있으므로 소켓이 동시에 경쟁하는 요청으로 풀링되지 않는 한 POST는 동일한 소켓에서 나가야 합니다.
예제
이 예제에서는 HTTP 서버에 데이터를 쓰는 코드를 보여 줍니다. 예제에 제공된 서버 이름 (www.wingtiptoys.com)은 가상이며 쓰기 액세스 권한이 있는 서버의 이름으로 바꿔야 합니다.
PCSTR pszData = "WinHttpWriteData Example";
DWORD dwBytesWritten = 0;
BOOL bResults = FALSE;
HINTERNET hSession = NULL,
hConnect = NULL,
hRequest = NULL;
// Use WinHttpOpen to obtain a session handle.
hSession = WinHttpOpen( L"A WinHTTP Example Program/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.wingtiptoys.com",
INTERNET_DEFAULT_HTTP_PORT, 0);
// Create an HTTP Request handle.
if (hConnect)
hRequest = WinHttpOpenRequest( hConnect, L"PUT",
L"/writetst.txt",
NULL, WINHTTP_NO_REFERER,
WINHTTP_DEFAULT_ACCEPT_TYPES,
0);
// Send a Request.
if (hRequest)
bResults = WinHttpSendRequest( hRequest,
WINHTTP_NO_ADDITIONAL_HEADERS,
0, WINHTTP_NO_REQUEST_DATA, 0,
(DWORD)strlen(pszData), 0);
// Write data to the server.
if (bResults)
bResults = WinHttpWriteData( hRequest, pszData,
(DWORD)strlen(pszData),
&dwBytesWritten);
// End the request.
if (bResults)
bResults = WinHttpReceiveResponse( hRequest, NULL);
// 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 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winhttp.h |
| 라이브러리 | Winhttp.lib |
| DLL | Winhttp.dll |
| 재배포 가능 파일 | Windows XP 및 Windows 2000에서 WinHTTP 5.0 및 인터넷 Explorer 5.01 이상. |