Compartilhar via


macro TRACELOGGING_DECLARE_PROVIDER (traceloggingprovider.h)

Encaminha declara um identificador para um provedor traceLogging.

Sintaxe

void TRACELOGGING_DECLARE_PROVIDER(
  [in]  handleVariable
);

Parâmetros

[in] handleVariable

O nome do identificador a ser encaminhado. Esse deve ser o nome de um identificador que foi definido em um arquivo .c ou .cpp usando TRACELOGGING_DEFINE_PROVIDER.

Retornar valor

Nenhum

Comentários

Use essa macro conforme necessário para encaminhar o identificador do provedor TraceLogging, por exemplo, em um arquivo de cabeçalho do componente. Essa macro não aloca armazenamento para o identificador do provedor. Para usar o provedor, você precisará usar TRACELOGGING_DEFINE_PROVIDER para definir o identificador e TraceLoggingRegister para registrá-lo.

Uma invocação como TRACELOGGING_DECLARE_PROVIDER(MyProviderHandle) pode ser considerada semelhante ao código como:

extern "C" const TraceLoggingHProvider MyProviderHandle;

Observação

O identificador do provedor declarado por TRACELOGGING_DECLARE_PROVIDER tem escopo de módulo. Ele pode ser usado conforme necessário no arquivo EXE, DLL ou SYS, mas não deve ser compartilhado com outras DLLs no mesmo processo. Cada arquivo EXE, DLL ou SYS deve definir seu próprio identificador de provedor e deve executar seu próprio Registro e Cancelar registro.

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

TRACELOGGING_DEFINE_PROVIDER

TraceLoggingWrite

Macros de wrapper traceLogging