Makro TraceLoggingSocketAddress (traceloggingprovider.h)

  • Artikel

Makro pembungkus TraceLogging yang menambahkan bidang dengan alamat soket ke acara.

Sintaks

void TraceLoggingSocketAddress(
  [in]            pValue,
  [in]            cbValue,
  [in, optional]  __VA_ARGS__
);

Parameter

[in] pValue

Penunjuk ke struktur sockaddr.

[in] cbValue

Ukuran, dalam byte, dari nilai yang ditujukkan oleh parameter pValue .

Catatan

Jumlah data yang diperlukan untuk bidang sockaddr bervariasi tergantung pada jenis alamat. Jika data disimpan dalam variabel gabungan, pastikan untuk mengatur parameter cbValue ke ukuran anggota gabungan yang benar (atau ke ukuran serikat) untuk menghindari pemotokan data.

[in, optional] __VA_ARGS__

Parameter nama, deskripsi, dan tag opsional untuk definisi bidang.

TraceLoggingSocketAddress dapat ditentukan dengan 2, 3, 4, atau 5 parameter. Jika parameter tidak ditentukan, default akan digunakan. Misalnya, TraceLoggingSocketAddress(&x.sockAddr, sizeof(x.sockAddr)) sama dengan TraceLoggingSocketAddress(&x.sockAddr, sizeof(x.sockAddr), "&x.sockAddr", "", 0).

  • [in, optional] name

    Nama yang digunakan untuk bidang peristiwa. Jika disediakan, parameter nama harus berupa string literal (bukan variabel) dan tidak boleh berisi karakter '\0'. Jika tidak disediakan, nama bidang peristiwa akan didasarkan pada pValue.

  • [in, optional] description

    Deskripsi nilai bidang peristiwa. Jika disediakan, parameter deskripsi harus berupa string literal dan akan disertakan dalam PDB.

  • [in, optional] tags

    Nilai bilangan bulat konstanta waktu kompilasi. Nilai 28 bit rendah akan disertakan dalam metadata bidang. Semantik nilai ini ditentukan oleh konsumen peristiwa. Selama pemrosesan peristiwa, nilai ini dapat diambil dari bidang Tag EVENT_PROPERTY_INFO .

Nilai kembali

Tidak ada

Keterangan

TraceLoggingSocketAddress(pValue, cbValue, ...) dapat digunakan sebagai parameter untuk pemanggilan makro TraceLoggingWrite . Setiap parameter TraceLoggingSocketAddress menambahkan satu bidang ke peristiwa.

Nilainya mungkin jenis sockaddr Windows, misalnya SOCKADDR, SOCKADDR_IN, SOCKADDR_IN6, SOCKADDR_STORAGE, dll. Peristiwa ini akan merekam data biner mentah dan ukuran data. Dekoder peristiwa akan menggunakan sa_family bidang untuk menentukan jenis alamat soket yang sebenarnya.

Catatan

Tidak semua dekode akan mendukung semua jenis keluarga sockaddr. Jika sockaddr yang tidak didukung ditemui, dekoder mungkin mendekode bidang sebagai data biner mentah alih-alih memformatnya sebagai alamat.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header traceloggingprovider.h

Lihat juga

TraceLoggingWrite

Makro pembungkus TraceLogging