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 會傳回對應至線程上暫止的最內部呼叫的取消介面，並已註冊取消物件。

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

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 combaseapi.h (包含 Objbase.h)
程式庫 Ole32.lib
Dll Ole32.dll