Função PdhVbGetCounterPathElements
A função PdhVbGetCounterPathElements analisa uma cadeia de caracteres de caminho de contador de desempenho totalmente qualificada em seus elementos individuais. Cada uma das variáveis de cadeia de caracteres deve ter o mesmo tamanho (BufferSize) e dimensionada e inicializada antes de ser usada nessa função.
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.
Function PdhVbGetCounterPathElements( _ ByVal PathString As String, _ ByVal MachineName As String, _ ByVal ObjectName As String, _ ByVal InstanceName As String, _ ByVal ParentInstance As String, _ ByVal CounterName As String, _ ByVal BufferSize As Long _ ) As Long
Parâmetros
-
PathString
-
Cadeia de caracteres de caminho de contador que deve ser dividida em seus elementos individuais.
-
MachineName
-
Cadeia de caracteres para receber o nome do computador.
-
ObjectName
-
Cadeia de caracteres para receber o nome do objeto.
-
InstanceName
-
Cadeia de caracteres para receber o nome da instância, se usado.
-
ParentInstance
-
Cadeia de caracteres para receber a instância pai, se usada.
-
CounterName
-
Cadeia de caracteres para receber o nome do contador.
-
BufferSize
-
Tamanho máximo de cada variável de cadeia de caracteres usada como um parâmetro para essa chamada de função.
Valor retornado
Se a função for bem-sucedida, ela retornará um inteiro Long igual a ERROR_SUCCESS.
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 buffers de cadeia de caracteres não é o tamanho correto. |
|
Um ou mais dos elementos de caminho do contador são muito grandes para o comprimento do buffer de retorno. |
|
Não foi possível alocar um buffer de memória temporário. |
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 |
|