Função InstallPerfDllW (loadperf.h)

Artigo
11/20/2024

Instala cadeias de caracteres de contador de desempenho, conforme definido em um arquivo .ini de entrada, no registro do sistema.

Observação a Microsoft recomenda que os desenvolvedores usem LoadPerfCounterTextStrings em vez de InstallPerfDll. LoadPerfCounterTextStrings chamadas InstallPerfDll internamente.

Sintaxe

LOADPERF_FUNCTION InstallPerfDllW(
  [in] LPCWSTR   szComputerName,
  [in] LPCWSTR   lpIniFile,
  [in] ULONG_PTR dwFlags
);

Parâmetros

[in] szComputerName

O nome do sistema. Isso deve ser NULL porque essa função não pode ser usada para instalar remotamente.

[in] lpIniFile

O nome do arquivo de inicialização que contém definições a serem adicionadas ao registro.

[in] dwFlags

Esse parâmetro pode ser LOADPERF_FLAGS_DISPLAY_USER_MSGS ((ULONG_PTR) 8).

Valor de retorno

Se a função for bem-sucedida, ela retornará VERDADEIRO e postará informações adicionais em um log de eventos do aplicativo. Caso contrário, ele retorna um código de erro que representa a condição que causou a falha.

Observações

Essa função não tem biblioteca de importação associada; você deve chamá-lo usando as funções LoadLibrary e GetProcAddress.

Nota

O cabeçalho loadperf.h define InstallPerfDll 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
da Plataforma de Destino	Windows
cabeçalho	loadperf.h
de DLL	Loadperf.dll

Consulte também

loadPerfCounterTextStrings

Compartilhar via