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

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

Confira também

IMofCompiler

WBEM_CHANGE_FLAG_TYPE

WBEM_COMPILER_OPTIONS

mofcomp