Função LoadPerfCounterTextStringsW (loadperf.h)

Artigo
11/20/2024

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

Sintaxe

LOADPERF_FUNCTION LoadPerfCounterTextStringsW(
  [in] LPWSTR 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, seguindo 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.

Valor de retorno

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 .

Observações

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

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	loadperf.h
biblioteca	Loadperf.lib
de DLL	Loadperf.dll

Consulte também

UnloadPerfCounterTextStrings

Compartilhar via