Share via

Função InstallPerfDllW (loadperf.h)

  • Artigo

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

Nota A Microsoft recomenda que os desenvolvedores usem LoadPerfCounterTextStrings em vez de InstallPerfDll. LoadPerfCounterTextStrings chama 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).

Retornar valor

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

Comentários

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

Observação

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

Confira também

LoadPerfCounterTextStrings