跳轉到主要內容

HCMockAddMock

設定 libHttpClient 在呼叫 HCHttpCallPerformAsync() 時傳回模擬回應,而不是進行網路呼叫。

語法

參數

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

另請參閱

mock
最後修改於 2026年10月6日