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 반환합니다.

함수가 실패하면 시스템 오류 코드를 반환합니다.

요구 사항

참고 항목

HttpSetRequestQueueProperty