Função PerfQueryInstance (perflib.h)
Recupera um ponteiro para a instância do conjunto de contadores especificado. Os provedores usam essa função.
Sintaxe
PPERF_COUNTERSET_INSTANCE PerfQueryInstance(
[in] HANDLE ProviderHandle,
[in] LPCGUID CounterSetGuid,
[in] PCWSTR Name,
[in] ULONG Id
);
Parâmetros
[in] ProviderHandle
O identificador do provedor. Use a variável de identificador que a ferramenta CTRPP gerou para você. Para o nome da variável, consulte o atributo symbol do elemento provider .
Windows Vista: A função PerfStartProvider retorna o identificador.
[in] CounterSetGuid
GUID que identifica exclusivamente o conjunto de contadores que você deseja consultar. Esse é o mesmo GUID especificado no atributo guid do elemento counterSet . Use a variável GUID que a ferramenta CTRPP gerou para você. Para o nome da variável, consulte o atributo de símbolo do elemento counterSet .
Windows Vista: A variável GUID não está disponível.
[in] Name
Cadeia de caracteres Unicode terminada em nulo que contém o nome da instância do conjunto de contadores que você deseja recuperar.
[in] Id
Identificador exclusivo da instância do conjunto de contadores que você deseja recuperar.
Valor retornado
Uma estrutura PERF_COUNTERSET_INSTANCE que contém a instância do conjunto de contadores ou NULL se a instância não existir.
Essa função retornará NULL se ocorrer um erro. Para determinar o erro ocorrido, chame GetLastError.
Comentários
Use o mesmo nome de instância e identificador que você usou ao chamar PerfCreateInstance para recuperar uma instância específica do conjunto de contadores.
Os provedores devem armazenar em cache o ponteiro para a instância quando criam a instância em vez de chamar essa função para recuperar o ponteiro.
Requisitos
| 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 |