Metodo CWbemProviderGlue::GetEmptyInstance(MethodContext*,LPCWSTR,CInstance**,LPCWSTR) (wbemglue.h)

[La classe CWbemProviderGlue fa parte di WMI Provider Framework, considerata allo stato finale e non sarà disponibile ulteriore sviluppo, miglioramenti o aggiornamenti per problemi non correlati alla sicurezza che interessano queste librerie. Le API MI devono essere usate per tutti i nuovi sviluppi.

Il metodo GetEmptyInstance recupera una singola istanza non popolata della classe specificata.

Sintassi

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

Parametri

pMethodContext

Puntatore al contesto corrente.

pszClassName

Nome della classe la cui istanza deve essere restituita.

ppInstance

Puntatore a un'istanza della classe CInstance usata per archiviare la nuova istanza. Questo puntatore deve essere rilasciato dal provider di framework che chiama GetEmptyInstance.

pszNamespace

Spazio dei nomi del nome della classe specificato da pszClassName. Questo parametro può essere NULL per indicare lo spazio dei nomi predefinito, ovvero root\cimv2.

Valore restituito

Restituisce WBEM_S_NO_ERROR se l'operazione ha avuto esito positivo, WBEM_E_OUT_OF_MEMORY se l'operazione non è riuscita a causa della mancanza di memoria o di qualsiasi altro codice di errore HRESULT .

Commenti

Il provider di framework passa il nome del provider a GetEmptyInstance, che restituisce un'istanza vuota. Un uso comune di questo metodo consiste nel popolare una proprietà oggetto incorporata. Questo metodo viene usato insieme a CInstance::SetEmbeddedObject.

Il secondo prototipo di funzione non è consigliato. Viene fornito solo per supportare il codice esistente.

Requisiti