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

O método IMofCompiler::CompileBuffer compila um buffer contendo dados MOF binários ou um buffer de texto no formato ASCII. Os arquivos MOF binários contêm dados analisados e devem ser armazenados no banco de dados. O método CompileBuffer aceita apenas matrizes de caracteres de vários bytes (buffers de cadeia de caracteres) que não são terminadas em NULL.

Sintaxe

HRESULT CompileBuffer(
  [in]      long                     BuffSize,
  [in]      BYTE                     *pBuffer,
  [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] BuffSize

Tamanho dos dados apontados pelo parâmetro pBuffer .

[in] pBuffer

Ponteiro para os dados binários do arquivo MOF ou um buffer de texto no formato ASCII.

[in] ServerAndNamespace

Nome do servidor e do namespace.

Esse parâmetro é ignorado, a menos que o parâmetro pBuffer aponte para um buffer de texto. Se o texto MOF for passado sem uma instrução #pragma , o arquivo MOF será compilado no namespace padrão. Se pBuffer apontar para um arquivo MOF binário, o parâmetro ServerAndNamespace deverá ser NULL.

[in] User

Nome do usuário que solicita o serviço.

Esse parâmetro especifica as credenciais para compilação em computadores remotos. Se o valor for NULL, o contexto do usuário será qualquer que seja o processo atual 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

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

[in] Password

Especifica as credenciais para compilação em computadores remotos. Se o valor for NULL, a senha do contexto atual será usada. Esse parâmetro sempre é ignorado ao se conectar ao computador local.

[in] lOptionFlags

Você pode combinar 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, ele adicionará o nome do arquivo à lista de arquivos a serem compilados durante a recuperação automática do banco de dados.

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 a adição do arquivo à lista de arquivos a serem compilados durante a recuperação automática do banco de dados.

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

[in] lClassFlags

Esse parâmetro é ignorado porque o arquivo MOF binário já contém as informações. O valor do parâmetro deve ser 0.

[in] lInstanceFlags

Ignorado porque o arquivo MOF binário já contém as informações. O valor do parâmetro deve ser 0.

[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.

Retornar valor

Esse método retornará WBEM_S_NO_ERROR se tiver êxito. Se o método não for bem-sucedido, ele retornará WBEM_S_FALSE.

Comentários

Se o parâmetro User assumir o domínio do formulário<\usuário>, o parâmetro Authority deverá ser NULL.

Os dados MOF binários podem ser gerados pelo método CreateBMOF , que armazena os dados MOF binários em um arquivo que pode ser lido antes de chamar o método CompileBuffer .

Requisitos

Confira também

IMofCompiler

WBEM_COMPILER_OPTIONS