Macro TraceLoggingSocketAddress (traceloggingprovider.h)

  • Artículo

Macro contenedora traceLogging que agrega un campo con una dirección de socket al evento.

Sintaxis

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

Parámetros

[in] pValue

Puntero a una estructura sockaddr.

[in] cbValue

Tamaño, en bytes, del valor al que apunta el parámetro pValue .

Nota

La cantidad de datos necesarios para un campo sockaddr varía según el tipo de dirección. Si los datos se almacenan en una variable de unión, asegúrese de establecer el parámetro cbValue en el tamaño del miembro de unión correcto (o en el tamaño de la unión) para evitar truncar los datos.

[in, optional] __VA_ARGS__

Parámetros de nombre, descripción y etiquetas opcionales para la definición de campo.

TraceLoggingSocketAddress se puede especificar con 2, 3, 4 o 5 parámetros. Si no se especifica un parámetro, se usará un valor predeterminado. Por ejemplo, TraceLoggingSocketAddress(&x.sockAddr, sizeof(x.sockAddr)) es equivalente a TraceLoggingSocketAddress(&x.sockAddr, sizeof(x.sockAddr), "&x.sockAddr", "", 0).

  • [in, optional] name

    Nombre que se va a usar para el campo de evento. Si se proporciona, el parámetro name debe ser un literal de cadena (no una variable) y no debe contener caracteres '\0'. Si no se proporciona, el nombre del campo de evento se basará en pValue.

  • [in, optional] description

    Descripción del valor del campo de evento. Si se proporciona, el parámetro description debe ser un literal de cadena y se incluirá en la PDB.

  • [in, optional] tags

    Valor entero constante en tiempo de compilación. Los 28 bits inferiores del valor se incluirán en los metadatos del campo. El consumidor de eventos define la semántica de este valor. Durante el procesamiento de eventos, este valor se puede recuperar del campo Etiquetas de EVENT_PROPERTY_INFO .

Valor devuelto

None

Observaciones

TraceLoggingSocketAddress(pValue, cbValue, ...) se puede usar como parámetro para una invocación de una macro TraceLoggingWrite . Cada parámetro TraceLoggingSocketAddress agrega un campo al evento.

El valor puede ser cualquier tipo de sockaddr de Windows, por ejemplo , SOCKADDR, SOCKADDR_IN, SOCKADDR_IN6, SOCKADDR_STORAGE, etc. El evento registrará los datos binarios sin procesar y el tamaño de los datos. El descodificador de eventos usará el sa_family campo para determinar el tipo real de la dirección del socket.

Nota

No todos los descodificadores admitirán todos los tipos de familia sockaddr. Si se encuentra un sockaddr no compatible, el descodificador podría descodificar el campo como datos binarios sin procesar en lugar de aplicarle formato como una dirección.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado traceloggingprovider.h

Consulte también

TraceLoggingWrite

Macros contenedoras traceLogging