Função PdhVbAddCounter
A função PdhVbAddCounter cria uma entrada de contador no objeto de consulta especificado e retorna um identificador para esse contador após a conclusão bem-sucedida.
Importante
A função que este tópico descreve pode ser alterada ou indisponível no futuro. Em vez disso, a Microsoft recomenda que você use as funções descritas em Funções de Contadores de Desempenho.
Função PdhVbAddCounter( _ ByVal QueryHandle As Long, _ ByVal CounterPath As String, _ ByVal CounterHandle As Long _ ) As Long
Parâmetros
-
QueryHandle
-
ID da consulta à qual esse contador deve ser atribuído. Esse valor é retornado pela função PdhVbOpenQuery .
-
CounterPath
-
Cadeia de caracteres de texto que especifica o nome do caminho do contador a ser adicionado à consulta. O conteúdo dessa cadeia de caracteres deve ser um caminho de contador válido, conforme obtido do navegador do contador ou de outra fonte.
-
CounterHandle
-
Referência exclusiva que identifica esse contador na consulta. Essa variável deve ser inicializada como zero antes que a função seja chamada. Ele contém um valor válido no retorno somente se a função for concluída com êxito.
Valor retornado
Se a função for bem-sucedida, ela retornará um inteiro Long igual a ERROR_SUCCESS e um novo identificador na variável CounterHandle .
Se a função falhar, o valor retornado será um código de erro do sistema ou um código de erro PDH. Veja a seguir os valores possíveis.
| Código de retorno | Descrição |
|---|---|
|
Um ou mais argumentos são inválidos ou incorretos. |
|
Não foi possível alocar um buffer de memória. |
|
O identificador de consulta não é válido. |
|
O contador especificado não foi encontrado. |
|
Não foi possível encontrar o objeto especificado. |
|
Não foi possível criar uma entrada de computador. |
|
Uma cadeia de caracteres de caminho de nome de contador vazia foi passada. |
|
Não foi possível determinar a função de cálculo desse contador. |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2003 [somente aplicativos da área de trabalho] |
| Biblioteca |
|
| DLL |
|