Fungsi CoGetCallerTID (combaseapi.h)

Artikel
08/22/2023

Mengembalikan pointer ke DWORD yang berisi ID apartemen utas pemanggil.

Sintaks

HRESULT CoGetCallerTID(
  [out] LPDWORD lpdwTID
);

Parameter

[out] lpdwTID

Menerima ID apartemen utas pemanggil. Untuk apartemen berulir tunggal (STA), ini adalah ID utas saat ini. Untuk apartemen multithreaded (MTA), nilainya adalah 0. Untuk apartemen netral (NA), nilainya adalah -1.

Mengembalikan nilai

Fungsi ini dapat mengembalikan nilai berikut.

Menampilkan kode	Deskripsi
S_TRUE	ID utas penelepon diatur dan pemanggil berada dalam proses yang sama.
S_FALSE	ID utas penelepon diatur dan pemanggil berada dalam proses yang berbeda.
E_OUTOFMEMORY	ID utas pemanggil tidak diatur.

Keterangan

Jika pemanggil tidak berjalan pada komputer yang sama, fungsi ini tidak mengembalikan ID apartemen dan nilai yang dikembalikan S_FALSE.

Tidak ada jaminan bahwa informasi yang dikembalikan dari API ini tidak dirusak, jadi jangan gunakan ID yang dikembalikan untuk membuat keputusan keamanan. ID hanya dapat digunakan untuk tujuan pengelogan dan diagnostik.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	combaseapi.h (termasuk Objbase.h)
Pustaka	Ole32.lib
DLL	Ole32.dll

Bagikan melalui