Função PdhVbUpdateLog
A função PdhVbUpdateLog atualiza a consulta atual e grava novos dados no arquivo de log. Essa função chama PdhUpdateLog.
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 PdhVbUpdateLog( _ ByVal hLog As PDH_HLOG, _ ByVal szUserString As LPCTSTR _ )
Parâmetros
-
hLog [in]
-
Manipule para o arquivo de log a ser atualizado. Esse identificador é retornado pela função PdhVbOpenLog .
-
szUserString [in]
-
Ponteiro para uma cadeia de caracteres que especifica os dados a serem adicionados ao arquivo de log. Isso geralmente é usado para comentários no arquivo de log.
Valor retornado
Se a função for bem-sucedida, ela retornará 0.
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 |
|---|---|
|
Os dados solicitados são maiores do que o buffer fornecido. Não é possível retornar os dados solicitados. |
|
Um ou mais buffers de cadeia de caracteres não é o tamanho correto. |
|
O identificador não é um objeto PDH válido. |
|
Não é possível abrir o arquivo de log especificado. |
|
Não é possível localizar o arquivo especificado. |
Comentários
Deve haver uma consulta aberta no momento e os contadores desejados devem ser adicionados a ela antes que essa função seja chamada.
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 |
|