Macro TraceLoggingSocketAddress (traceloggingprovider.h)

  • Artigo

Macro wrapper TraceLogging que adiciona um campo com um endereço de soquete ao evento.

Sintaxe

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

Parâmetros

[in] pValue

Um ponteiro para uma estrutura sockaddr.

[in] cbValue

O tamanho, em bytes, do valor apontado pelo parâmetro pValue .

Observação

A quantidade de dados necessária para um campo sockaddr varia dependendo do tipo de endereço. Se os dados forem armazenados em uma variável de união, defina o parâmetro cbValue para o tamanho do membro de união correto (ou para o tamanho da união) para evitar truncar os dados.

[in, optional] __VA_ARGS__

Parâmetros opcionais de nome, descrição e marcas para a definição de campo.

TraceLoggingSocketAddress pode ser especificado com 2, 3, 4 ou 5 parâmetros. Se um parâmetro não for especificado, um padrão será usado. Por exemplo, TraceLoggingSocketAddress(&x.sockAddr, sizeof(x.sockAddr)) é equivalente a TraceLoggingSocketAddress(&x.sockAddr, sizeof(x.sockAddr), "&x.sockAddr", "", 0).

  • [in, optional] name

    O nome a ser usado para o campo de evento. Se fornecido, o parâmetro name deve ser um literal de cadeia de caracteres (não uma variável) e não deve conter nenhum caractere '\0'. Se não for fornecido, o nome do campo de evento será baseado em pValue.

  • [in, optional] description

    A descrição do valor do campo de evento. Se fornecido, o parâmetro de descrição deve ser um literal de cadeia de caracteres e será incluído no PDB.

  • [in, optional] tags

    Um valor inteiro constante de tempo de compilação. Os 28 bits baixos do valor serão incluídos nos metadados do campo. A semântica desse valor é definida pelo consumidor do evento. Durante o processamento de eventos, esse valor pode ser recuperado do campo Marcas EVENT_PROPERTY_INFO .

Retornar valor

Nenhum

Comentários

TraceLoggingSocketAddress(pValue, cbValue, ...) pode ser usado como um parâmetro para uma invocação de uma macro TraceLoggingWrite . Cada parâmetro TraceLoggingSocketAddress adiciona um campo ao evento.

O valor pode ser qualquer tipo sockaddr do Windows, por exemplo, SOCKADDR, SOCKADDR_IN, SOCKADDR_IN6, SOCKADDR_STORAGE etc. O evento registrará os dados binários brutos e o tamanho dos dados. O decodificador de evento usará o sa_family campo para determinar o tipo real do endereço do soquete.

Observação

Nem todos os decodificadores darão suporte a todos os tipos de família sockaddr. Se um sockaddr sem suporte for encontrado, o decodificador poderá decodificar o campo como dados binários brutos em vez de formatá-lo como um endereço.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho traceloggingprovider.h

Confira também

TraceLoggingWrite

Macros de wrapper traceLogging