Fungsi CoGetApartmentType (combaseapi.h)

Artikel
08/22/2023

Mengembalikan tipe apartemen saat ini dan tipe kualifikasi.

Sintaks

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

Parameter

[out] pAptType

Nilai enumerasi APTTYPE yang menentukan jenis apartemen saat ini.

[out] pAptQualifier

Nilai enumerasi APTTYPEQUALIFIER yang menentukan kualifikasi jenis apartemen saat ini.

Menampilkan nilai

Mengembalikan S_OK jika panggilan berhasil. Jika tidak, salah satu kode kesalahan berikut dikembalikan.

Menampilkan kode	Deskripsi
E_FAIL	Panggilan tidak berhasil mengkueri tipe apartemen saat ini dan tipe kualifikasi.
E_INVALIDARG	Nilai parameter yang tidak valid diberikan ke fungsi . Secara khusus, satu atau kedua parameter diatur ke NULL oleh pemanggil.
CO_E_NOTINITIALIZED	CoInitialize atau CoInitializeEx tidak dipanggil pada utas ini sebelum memanggil CoGetApartmentType.

Keterangan

Pada platform Windows sebelum Windows 7, tindakan berikut harus diambil pada utas untuk mengkueri jenis apartemen:

Panggil CoGetContextToken untuk mendapatkan token konteks saat ini.
Transmisikan token konteks ke pointer IUnknown*.
Panggil metode QueryInterface pada penunjuk tersebut untuk mendapatkan antarmuka IComThreadingInfo .
Panggil metode GetCurrentApartmentType dari antarmuka IComThreadingInfo untuk mendapatkan jenis apartemen saat ini.

Dalam skenario multithreaded, ada kondisi balapan yang berpotensi menyebabkan Pelanggaran Akses dalam proses saat menjalankan urutan operasi di atas. Fungsi CoGetApartmentType direkomendasikan karena tidak berpotensi menimbulkan Pelanggaran Akses.

Persyaratan


Klien minimum yang didukung	Windows 7 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	combaseapi.h (termasuk Objbase.h)
Pustaka	Ole32.lib
DLL	Ole32.dll

Lihat juga

APTTYPE

APTTYPEQUALIFIER

Bagikan melalui