coGetApartmentType 函式 (combaseapi.h)

傳回目前的 Apartment 類型和類型限定詞。

語法

HRESULT CoGetApartmentType(
  [out] APTTYPE          *pAptType,
  [out] APTTYPEQUALIFIER *pAptQualifier
);

[out] pAptType

指定目前 Apartment 類型的APTTYPE列舉值。

[out] pAptQualifier

指定目前 Apartment 之型別限定詞的APTTYPEQUALIFIER列舉值。

如果呼叫成功，則傳回S_OK。否則，會傳回下列其中一個錯誤碼。

傳回碼	Description
E_FAIL	呼叫無法成功查詢目前的 Apartment 類型和類型限定詞。
E_INVALIDARG	已將不正確參數值提供給函式。具體而言，呼叫端已將其中一或兩個參數設定為 Null 。
CO_E_NOTINITIALIZED	在呼叫CoGetApartmentType之前，未在此執行緒上呼叫CoInitialize或CoInitializeEx。

在 Windows 7 之前的 Windows 平臺上，必須線上程上採取下列動作來查詢 Apartment 類型：

在多執行緒案例中，在執行上述作業序列時，可能會造成進程內的存取違規。建議 使用 CoGetApartmentType 函式，因為它可能不會產生存取違規。


最低支援的用戶端	Windows 7 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2008 R2 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	combaseapi.h (包含 Objbase.h)
程式庫	Ole32.lib
Dll	Ole32.dll