Metodo IVdsService::GetObject (vds.h)

  • Articolo

[A partire da Windows 8 e Windows Server 2012, l'interfaccia COM del servizio disco virtuale viene sostituita dall'API gestione archiviazione di Windows.]

Restituisce un puntatore a un oggetto per l'oggetto identificato.

Sintassi

HRESULT GetObject(
  [in]  VDS_OBJECT_ID   ObjectId,
  [in]  VDS_OBJECT_TYPE type,
  [out] IUnknown        **ppObjectUnk
);

Parametri

[in] ObjectId

GUID dell'oggetto desiderato.

[in] type

Valore di enumerazione VDS_OBJECT_TYPE che specifica il tipo di oggetto. VDS_OT_UNKNOWN, VDS_OT_PROVIDER, VDS_OT_ASYNC, VDS_OT_ENUM e VDS_OT_OPEN_VDISK non sono supportati.

[out] ppObjectUnk

Puntatore a un buffer che riceve il puntatore IUnknown all'oggetto . Quando il puntatore non è più necessario, il chiamante deve rilasciarlo chiamando il metodo IUnknown::Release .

Valore restituito

Questo metodo può restituire valori HRESULT standard, ad esempio E_INVALIDARG o E_OUTOFMEMORY e valori restituiti specifici di VDS. Può anche restituire codici di errore di sistema convertiti usando la macro HRESULT_FROM_WIN32 . Gli errori possono provenire dal VDS stesso o dal provider VDS sottostante in uso. I valori restituiti possibili includono quanto segue.

Codice/valore restituito Descrizione
VDS_E_OBJECT_NOT_FOUND
0x80042405L
 Non viene trovato un oggetto con l'identificatore e il tipo specificati.
VDS_E_INITIALIZED_FAILED
0x80042401L
 Impossibile inizializzare VDS. Se un'applicazione chiama questo metodo prima che il servizio completi l'inizializzazione, il metodo viene bloccato fino al completamento dell'inizializzazione. Se l'inizializzazione ha esito negativo, viene restituito questo errore.

Commenti

Le notifiche VDS restituiscono un identificatore di oggetto anziché un puntatore a oggetti. I chiamanti usano questo metodo per ottenere un puntatore all'oggetto a cui fa riferimento nella notifica.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione vds.h
Libreria Uuid.lib

Vedi anche

IVdsService

VDS_OBJECT_TYPE