Metode IHttpTraceContext::GetTraceActivityId

Mengembalikan pengidentifikasi aktivitas pelacakan untuk konteks pelacakan.

Sintaks

virtual LPCGUID GetTraceActivityId(  
) = 0;  

Parameter

Metode ini tidak memerlukan parameter.

Tampilkan Nilai

Penunjuk ke GUID konstanta; jika tidak, NULL.

Keterangan

Perilaku metode ini tergantung pada implementasi. Beberapa implementasi selalu mengembalikan NULL, sementara yang lain memanggil metode IHttpRequest::GetRawHttpRequest pada pointer IHttpRequest internal dan mengonversi penunjuk HTTP_REQUEST yang dikembalikan ke const penunjuk GUID.

Perhatian

Karena beberapa pelaksana mengembalikan NULL, selalu verifikasi bahwa LPCGUID yang dikembalikan bukan NULL sebelum Anda melakukan operasi apa pun pada data ini.

Catatan untuk Pelaksana

Pelaksana IHttpTraceContext bertanggung jawab atas manajemen memori dengan data ini; oleh karena itu, IHttpTraceContext pelaksana yang menggunakan alokasi memori dinamis harus melepaskan atau memanggil delete pada pointer LPCGUID ketika tidak lagi diperlukan.

Catatan untuk Penelepon

IHttpTraceContext pelaksana bertanggung jawab atas manajemen memori dengan data ini; oleh karena itu, IHttpTraceContext klien tidak boleh merilis atau memanggil delete penunjuk LPCGUID yang dikembalikan ketika data ini tidak lagi diperlukan. Selain itu, klien tidak boleh mentransmisikan data ini ke pointer yang bukan const atau mengubah status memori yang direferensikan oleh LPCGUID ini; jika tidak, pelanggaran akses akan dilemparkan atau data akan menjadi tidak valid.

Untuk informasi selengkapnya tentang cara membuat dan menyebarkan modul DLL asli, lihat Panduan: Membuat modul HTTP Request-Level Dengan Menggunakan Kode Asli.

Persyaratan

Jenis	Deskripsi
Klien	- IIS 7.0 di Windows Vista - IIS 7.5 di Windows 7 - IIS 8.0 di Windows 8 - IIS 10.0 pada Windows 10
Server	- IIS 7.0 di Windows Server 2008 - IIS 7.5 di Windows Server 2008 R2 - IIS 8.0 di Windows Server 2012 - IIS 8.5 di Windows Server 2012 R2 - IIS 10.0 di Windows Server 2016
Produk	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 - IIS Express 7.5, IIS Express 8.0, IIS Express 10.0
Header	Httpserv.h

Lihat juga

Antarmuka IHttpTraceContext