Metodo IVdsService::GetObject (vds.h)

Articolo
03/13/2024

[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

Condividi tramite