HttpSetRequestProperty 함수(http.h)
HttpSetRequestProperty 함수는 새 속성을 설정하거나 지정된 요청에서 기존 속성을 수정합니다.
구문
HTTPAPI_LINKAGE ULONG HttpSetRequestProperty(
[in] HANDLE RequestQueueHandle,
[in] HTTP_OPAQUE_ID Id,
[in] HTTP_REQUEST_PROPERTY PropertyId,
[in] PVOID Input,
[in] ULONG InputPropertySize,
[in] LPOVERLAPPED Overlapped
);
매개 변수
[in] RequestQueueHandle
요청을 받은 요청 큐에 대한 핸들입니다. 요청 큐가 생성되고 HttpCreateRequestQueue 함수에 대한 호출에서 해당 핸들이 반환됩니다.
[in] Id
요청의 불투명 ID입니다. 이 ID는 HttpReceiveHttpRequest에서 반환된 HTTP_REQUEST 구조체의 RequestId 멤버에 있습니다.
[in] PropertyId
설정된 속성 형식을 설명하는 HTTP_REQUEST_PROPERTY 열거형의 멤버입니다. 다음 중 하나여야 합니다.
| 속성 | 의미 | | HttpRequestPropertyStreamError | 요청에 대한 스트림 오류를 설정합니다. |
[in] Input
속성 정보를 포함하는 버퍼에 대한 포인터입니다.
설정된 속성에 따라 다음 속성 정보 형식 중 하나를 가리킬 수 있습니다.
| 속성 | 구성 유형 | | HttpRequestPropertyStreamError | HTTP_REQUEST_PROPERTY_STREAM_ERROR 구조 |
[in] InputPropertySize
Input 매개 변수가 가리키는 버퍼의 길이(바이트)입니다.
[in] Overlapped
비동기 호출의 경우 pOverlapped 를 OVERLAPPED 구조를 가리키도록 설정합니다. 동기 호출의 경우 NULL로 설정합니다.
동기 호출은 작업이 완료될 때까지 차단되지만 비동기 호출은 즉시 ERROR_IO_PENDING 반환하고 호출 애플리케이션은 GetOverlappedResult 또는 I/O 완료 포트를 사용하여 작업이 완료되는 시기를 결정합니다. 동기화에 OVERLAPPED 구조를 사용하는 방법에 대한 자세한 내용은 동기화 및 겹치는 입력 및 출력을 참조하세요.
반환 값
함수가 성공하면 ERROR_SUCCESS 반환합니다.
함수가 실패하면 시스템 오류 코드를 반환합니다.
요구 사항
대상 플랫폼 | Windows |
헤더 | http.h |
라이브러리 | Httpapi.lib |
DLL | Httpapi.dll |