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

Requisito	Valor
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_COMPILER_OPTIONS