Compartilhar via

Método CWbemProviderGlue::GetEmptyInstance(MethodContext*,LPCWSTR,CInstance**,LPCWSTR) (wbemglue.h)

  • Artigo

[A classe CWbemProviderGlue faz parte do WMI Provider Framework que agora é considerado em estado final e nenhum desenvolvimento, melhoria ou atualização adicional estará disponível para problemas não relacionados à segurança que afetarem essas bibliotecas. As APIs de MI devem ser usadas em todos os novos desenvolvimentos.]

O método GetEmptyInstance recupera uma única instância não populada da classe especificada.

Sintaxe

HRESULT GetEmptyInstance(
  MethodContext *pMethodContext,
  LPCWSTR       pszClassName,
  CInstance     **ppInstance,
  LPCWSTR       pszNamespace
);

Parâmetros

pMethodContext

Ponteiro para o contexto atual.

pszClassName

Nome da classe cuja instância deve ser retornada.

ppInstance

Ponteiro para uma instância da classe CInstance usada para armazenar a nova instância. Esse ponteiro deve ser liberado pelo provedor de estrutura que chama GetEmptyInstance.

pszNamespace

Namespace do nome da classe especificado por pszClassName. Esse parâmetro pode ser NULL para indicar o namespace padrão, que é root\cimv2.

Valor retornado

Retorna WBEM_S_NO_ERROR se a operação foi bem-sucedida, WBEM_E_OUT_OF_MEMORY se a operação falhou devido à falta de memória ou a qualquer outro código de erro HRESULT .

Comentários

O provedor de estrutura passa o nome do provedor para GetEmptyInstance, que retorna uma instância vazia. Um uso comum desse método é preencher uma propriedade de objeto inserida. Esse método é usado em conjunto com CInstance::SetEmbeddedObject.

O segundo protótipo de função não é recomendado. Ele é fornecido apenas para dar suporte ao código existente.

Requisitos

   
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho wbemglue.h (inclua FwCommon.h)
Biblioteca FrameDyn.lib
DLL FrameDynOS.dll; FrameDyn.dll