Compartilhar via

Função LoadPerfCounterTextStringsA (loadperf.h)

  • Artigo

Carrega no computador os objetos de desempenho e contadores definidos no arquivo de inicialização especificado.

Sintaxe

LOADPERF_FUNCTION LoadPerfCounterTextStringsA(
  [in] LPSTR lpCommandLine,
  [in] BOOL  bQuietModeArg
);

Parâmetros

[in] lpCommandLine

Cadeia de caracteres terminada em nulo que consiste em uma ou mais letras arbitrárias, um espaço e, em seguida, o nome do arquivo de inicialização (.ini). O nome pode incluir o caminho para o arquivo de inicialização.

A função usa apenas o arquivo de inicialização; o primeiro argumento é descartado. Por exemplo, para carregar um arquivo de inicialização chamado "myfile.ini", a cadeia de caracteres commandLine pode ser "xx myfile.ini". As letras antes do espaço (aqui "xx") são descartadas e a segunda parte, após o espaço, é interpretada como a especificação do arquivo de inicialização.

[in] bQuietModeArg

Defina como TRUE para impedir que a função exiba a saída da ferramenta Lodctr ; caso contrário, FALSE. Esse parâmetro só terá significado se o aplicativo for executado em um prompt de comando.

Retornar valor

Se a função for bem-sucedida, ela retornará ERROR_SUCCESS.

Se a função falhar, o valor retornado será um dos códigos de erro do sistema.

Comentários

Essa função fornece uma API para a funcionalidade fornecida pela ferramenta Lodctr . Para obter informações sobre o Lodctr, consulte Adicionando nomes e descrições de contadores ao Registro.

Observação

O cabeçalho loadperf.h define LoadPerfCounterTextStrings como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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]
Plataforma de Destino Windows
Cabeçalho loadperf.h
Biblioteca Loadperf.lib
DLL Loadperf.dll

Confira também

UnloadPerfCounterTextStrings