CoGetCancelObject 函式 (combaseapi.h)

取得呼叫控件介面的指標，通常是 ICancelMethodCalls，該對象對應至相同或另一個用戶端線程上擱置的輸出 COM 方法呼叫。

語法

HRESULT CoGetCancelObject(
  [in]  DWORD  dwThreadId,
  [in]  REFIID iid,
  [out] void   **ppUnk
);

[in] dwThreadId

要取消暫止 COM 呼叫的線程標識碼。如果此參數為 0，則呼叫位於目前的線程上。

[in] iid

取消物件上介面的全域唯一標識符，要取消的呼叫。此自變數通常是IID_ICancelMethodCalls。

[out] ppUnk

接收 riid 所指定介面的指標位址。

此函式可以傳回標準傳回值E_FAIL、E_INVALIDARG、E_OUTOFMEMORY和E_UNEXPECTED，以及下列值。

傳回碼	描述
S_OK	已成功擷取呼叫控件物件。
E_NOINTERFACE	執行呼叫的物件不支援 riid所指定的介面。

如果透過巢狀呼叫在相同線程上擱置兩個或多個呼叫，線程標識碼可能不足以識別要取消的呼叫。在此情況下， CoGetCancelObject 會傳回對應至線程上暫止的最內部呼叫的取消介面，並已註冊取消物件。

此函式找不到異步呼叫的取消物件。