HCMockAddMock
HCHttpCallPerformAsync()가 호출될 때 네트워크 호출을 수행하는 대신 모의 응답을 반환하도록 libHttpClient를 구성합니다.
구문
HRESULT HCMockAddMock(
HCMockCallHandle call,
const char* method,
const char* url,
const uint8_t* requestBodyBytes,
uint32_t requestBodySize
)
매개 변수
call _In_
형식: HCMockCallHandle
HCMockResponseSet*()를 사용하여 구성된 모의 작업을 나타내는 이 HC_MOCK_CALL_HANDLE입니다.
method _In_opt_z_
형식: char*
모의 작업이 특정 URL에만 적용되도록 하려면 UTF-8로 인코딩된 메서드 및 URL을 전달합니다.
url _In_opt_z_
형식: char*
모의 작업이 특정 URL에만 적용되도록 하려면 UTF-8로 인코딩된 메서드 및 URL을 전달합니다.
requestBodyBytes _In_reads_bytes_opt_(requestBodySize)
형식: uint8_t*
모의 작업이 특정 URL 및 요청 문자열에만 적용되도록 하려면 메서드, URL 및 문자열 본문을 전달합니다.
requestBodySize _In_
형식: uint32_t
requestBodyBytes의 크기(바이트)입니다.
반환 값
형식: HRESULT
이 API 작업에 대한 결과 코드입니다. 가능한 값은 S_OK, E_INVALIDARG, E_OUTOFMEMORY 또는 E_FAIL입니다.
설명
모의 응답을 정의하려면 모의 작업을 나타내는 HCMockCallCreate()로 새 HC_MOCK_CALL_HANDLE을 만듭니다. 그런 후 HCMockResponseSet*()를 사용하여 모의 응답을 설정합니다. 기본적으로 모의 응답은 모든 HTTP 호출에 대해 반환됩니다. 모의 작업이 특정 URL에만 적용되도록 하려면 URL을 전달합니다. 모의 작업이 특정 URL 및 요청 본문에만 적용되도록 하려면 URL 및 본문을 전달합니다. HC_MOCK_CALL_HANDLE이 원하는 대로 구성된 후에는 HCMockAddMock()를 호출하여 시스템에 모의 작업을 추가합니다. 모의 응답 집합을 사용하여 HCMockAddMock()를 여러 번 호출하여 여러 개의 활성 모의 응답을 설정할 수 있습니다. HTTP 호출이 설정된 모의 응답에 대해 일치하면, 이후의 각 HCHttpCallPerformAsync() 호출 순서에 따라 실행됩니다. 마지막으로 일치하는 모의 응답이 적중하면 HCHttpCallPerformAsync()에 대한 후속 호출마다 마지막으로 일치하는 모의 응답이 반복됩니다.
요구 사항
헤더: mock.h
라이브러리: libHttpClient.GDK.lib