Compartilhar via


Função PerfStartProvider (perflib.h)

Registra o provedor.

Sintaxe

ULONG PerfStartProvider(
  [in]           LPGUID         ProviderGuid,
  [in, optional] PERFLIBREQUEST ControlCallback,
  [out]          HANDLE         *phProvider
);

Parâmetros

[in] ProviderGuid

GUID que identifica exclusivamente o provedor. O atributo providerGuid do elemento provider especifica o GUID.

[in, optional] ControlCallback

Função ControlCallback que o PERFLIB chama para notificá-lo das solicitações do consumidor, como uma solicitação para adicionar ou remover contadores da consulta. Esse parâmetro será definido se o atributo de retorno de chamada do elemento counters for "custom"; caso contrário, NULL.

[out] phProvider

Manipule para o provedor. Você deve chamar PerfStopProvider para liberar recursos associados ao identificador.

Retornar valor

Se a função for bem-sucedida, ela retornará ERROR_SUCCESS.

Se a função falhar, o valor retornado será um código de erro do sistema.

Comentários

A função CounterInitialize chama essa função; não chame essa função diretamente.

Windows Vista: A função PerfAutoInitialize chama essa função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho perflib.h
Biblioteca Advapi32.lib
DLL Advapi32.dll

Confira também

PerfStopProvider