Macro TraceLoggingSocketAddress (traceloggingprovider.h)

Articolo
08/26/2023

Macro wrapper TraceLogging che aggiunge un campo con un indirizzo socket all'evento.

Sintassi

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

Parametri

[in] pValue

Puntatore a una struttura sockaddr.

[in] cbValue

Dimensione, in byte, del valore a cui punta il parametro pValue .

Nota

La quantità di dati necessari per un campo sockaddr varia a seconda del tipo di indirizzo. Se i dati vengono archiviati in una variabile di unione, assicurarsi di impostare il parametro cbValue sulle dimensioni del membro di unione corretto (o sulle dimensioni dell'unione) per evitare di troncare i dati.

[in, optional] __VA_ARGS__

Parametri di nome, descrizione e tag facoltativi per la definizione del campo.

TraceLoggingSocketAddress può essere specificato con 2, 3, 4 o 5 parametri. Se non viene specificato un parametro, verrà utilizzato un valore predefinito. Ad esempio, TraceLoggingSocketAddress(&x.sockAddr, sizeof(x.sockAddr)) equivale a TraceLoggingSocketAddress(&x.sockAddr, sizeof(x.sockAddr), "&x.sockAddr", "", 0).

[in, optional] name

Nome da utilizzare per il campo dell'evento. Se specificato, il parametro name deve essere un valore letterale stringa (non una variabile) e non deve contenere caratteri '\0'. Se non specificato, il nome del campo evento sarà basato su pValue.
[in, optional] description

Descrizione del valore del campo evento. Se specificato, il parametro description deve essere un valore letterale stringa e verrà incluso nel PDB.
[in, optional] tags

Valore intero costante in fase di compilazione. I 28 bit bassi del valore verranno inclusi nei metadati del campo. La semantica di questo valore è definita dal consumer di eventi. Durante l'elaborazione degli eventi, questo valore può essere recuperato dal campo tag EVENT_PROPERTY_INFO .

Valore restituito

nessuno

Osservazioni

TraceLoggingSocketAddress(pValue, cbValue, ...) può essere usato come parametro per una chiamata di una macro TraceLoggingWrite . Ogni parametro TraceLoggingSocketAddress aggiunge un campo all'evento.

Il valore può essere qualsiasi tipo sockaddr di Windows, ad esempio SOCKADDR, SOCKADDR_IN, SOCKADDR_IN6, SOCKADDR_STORAGE e così via. L'evento registrerà i dati binari non elaborati e le dimensioni dei dati. Il decodificatore di eventi userà il sa_family campo per determinare il tipo effettivo dell'indirizzo del socket.

Nota

Non tutti i decodificatori supporteranno tutti i tipi di famiglia sockaddr. Se viene rilevato un sockaddr non supportato, il decodificatore potrebbe decodificare il campo come dati binari non elaborati anziché formattarlo come indirizzo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	traceloggingprovider.h

Vedi anche

TraceLoggingWrite

Macro wrapper TraceLogging

Condividi tramite