Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
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 |
|---|---|
|
ID utas penelepon diatur dan pemanggil berada dalam proses yang sama. |
|
ID utas penelepon diatur dan pemanggil berada dalam proses yang berbeda. |
|
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 |