Compartilhar via

Método IMofCompiler::CompileFile (wbemcli.h)

  • Artigo

O método IMofCompiler::CompileFile compila um arquivo MOF (incluindo MOFs binários) e armazena as informações no repositório WMI. Esse método executa a mesma operação que o comando Mofcomp .

Sintaxe

HRESULT CompileFile(
  [in]      LPWSTR                   FileName,
  [in]      LPWSTR                   ServerAndNamespace,
  [in]      LPWSTR                   User,
  [in]      LPWSTR                   Authority,
  [in]      LPWSTR                   Password,
  [in]      LONG                     lOptionFlags,
  [in]      LONG                     lClassFlags,
  [in]      LONG                     lInstanceFlags,
  [in, out] WBEM_COMPILE_STATUS_INFO *pInfo
);

Parâmetros

[in] FileName

O nome do arquivo a ser compilado.

[in] ServerAndNamespace

O caminho para o namespace padrão em que todas as classes ou instâncias são gravadas.

Você pode especificar um namespace em um computador remoto ("\computer\root", por exemplo). Esse valor pode ser substituído pelo comando #pragma e não deve ser usado se a recuperação automática for desejada. Se FOR NULL, o namespace raiz\padrão no computador local será o padrão.

[in] User

Um valor que especifica as credenciais usadas para compilar em computadores remotos. Se o valor for NULL, o contexto do usuário será qualquer que seja o processo de chamada que está usando. Isso sempre é ignorado ao se conectar ao computador local. Para obter mais informações, consulte a seção Comentários.

[in] Authority

Um valor que especifica as credenciais para compilação em computadores remotos. Se o valor for NULL, o contexto de autoridade será qualquer que seja o processo de chamada que está usando. Isso sempre é ignorado ao se conectar ao computador local. Para obter mais informações, consulte a seção Comentários.

[in] Password

Um valor que especifica as credenciais para compilação em computadores remotos. Se o valor for NULL, a senha do contexto atual será usada. Isso sempre é ignorado ao se conectar ao computador local.

[in] lOptionFlags

Um parâmetro que, quando o método CompileFile é usado, habilita a combinação de um ou mais dos sinalizadores a seguir.

WBEM_FLAG_CHECK_ONLY

Executa apenas uma sintaxe marcar.

WBEM_FLAG_AUTORECOVER

Se o método for bem-sucedido, adicionará o nome do arquivo à lista de arquivos a serem compilados durante a recuperação automática do banco de dados.

Lembre-se de que esse sinalizador não pode ser combinado com os sinalizadores de namespace, classe ou instância.

WBEM_FLAG_CONSOLE_PRINT

Envia várias mensagens úteis para o console.

WBEM_FLAG_DONT_ADD_TO_LIST

Impede que o arquivo seja adicionado à lista de arquivos compilados durante a recuperação automática do banco de dados.

Esse sinalizador não é compatível com WBEM_FLAG_AUTORECOVER.

[in] lClassFlags

Os sinalizadores que controlam a criação de classes.

Os parâmetros podem ser 0 ou uma combinação dos valores a seguir.

WBEM_FLAG_UPDATE_ONLY

Impede a criação de uma classe.

Você pode combinar esse sinalizador com WBEM_FLAG_UPDATE_SAFE_MODE ou WBEM_FLAG_UPDATE_FORCE_MODE.

WBEM_FLAG_CREATE_ONLY

Permite apenas a criação de classe.

Talvez você não combine esse sinalizador com os outros sinalizadores.

WBEM_FLAG_UPDATE_SAFE_MODE

Atualizações a classe, a menos que existam conflitos.

Você pode combinar esse sinalizador com WBEM_FLAG_UPDATE_ONLY.

WBEM_FLAG_UPDATE_FORCE_MODE

Atualizações e resolve conflitos sempre que possível. O uso do modo de força para atualizar uma classe estática resulta na exclusão de todas as instâncias dessa classe. Forçar a atualização em uma classe de provedor não exclui instâncias da classe .

Você pode combinar esse sinalizador com llnstanceFlags.

[in] lInstanceFlags

Os sinalizadores que controlam a criação de instâncias.

Os valores de parâmetro podem ser 0 ou um dos sinalizadores a seguir.

WBEM_FLAG_UPDATE_ONLY

Permitir apenas atualizações.

WBEM_FLAG_CREATE_ONLY

Permitir apenas novas instâncias.

[in, out] pInfo

Ponteiro para um WBEM_COMPILE_STATUS_INFO que descreve um erro.

Se o valor do parâmetro não for NULL, ocorrerá um erro e a estrutura será preenchida com informações de erro.

Valor retornado

Esse método pode retornar um desses valores.

2

Aviso de que #pragma instrução autorecover não está presente. Essa instrução deve ser uma das primeiras linhas do arquivo MOF.

Comentários

Se o parâmetro User estiver na forma de <domain\user>, o parâmetro Authority deverá ser NULL.

Requisitos

   
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho wbemcli.h (inclua Wbemidl.h)
Biblioteca Wbemuuid.lib
DLL Mofd.dll

Confira também

IMofCompiler

WBEM_CHANGE_FLAG_TYPE

WBEM_COMPILER_OPTIONS

mofcomp