Função PdhVbGetOneCounterPath
A função PdhVbGetOneCounterPath exibe uma caixa de diálogo que permite que o usuário navegue pelos contadores de desempenho disponíveis e selecione um contador. O contador selecionado é retornado na variável PathString . A variável PathString deve ser dimensionada e inicializada antes que essa função seja chamada e o tamanho dimensionado deve ser indicado pela variável PathLength .
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 PdhVbGetOneCounterPath( _ ByVal PathString as String, _ ByVal PathLength As Long, _ ByVal DetailLevel As Long, _ ByVal CaptionString As String _ ) As Long
Parâmetros
-
PathString
-
Variável de cadeia de caracteres inicializada usada para receber o caminho do contador selecionado pelo usuário.
-
PathLength
-
Comprimento do PathString inicializado.
-
DetailLevel
-
Tipos de contadores a serem exibidos na caixa de diálogo. Esse parâmetro pode usar um dos valores a seguir.
Valor Significado - PERF_DETAIL_ADVANCED
Contadores que o usuário avançado provavelmente entenderá, além dos contadores de usuário iniciante. - PERF_DETAIL_EXPERT
Contadores que o usuário especialista e o desenvolvedor de software provavelmente entenderão, além dos contadores para os usuários iniciantes e avançados. - PERF_DETAIL_NOVICE
Somente contadores que o usuário iniciante provavelmente entenderá. - PERF_DETAIL_WIZARD
Todos os contadores no sistema. -
CaptionString
-
Variável de cadeia de caracteres que contém o texto que será exibido na barra de legenda da caixa de diálogo.
Valor retornado
A função retorna o número de caracteres gravados no buffer PathString .
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 |
|