Condividi tramite


Metodo IVdsVolume2::GetProperties2 (vds.h)

[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 le informazioni sulle proprietà per il volume corrente. Questo metodo è identico al metodo IVdsVolume::GetProperties , ad eccezione del fatto che restituisce una struttura VDS_VOLUME_PROP2 anziché una struttura VDS_VOLUME_PROP .

Sintassi

HRESULT GetProperties2(
  [out] VDS_VOLUME_PROP2 *pVolumeProperties
);

Parametri

[out] pVolumeProperties

Indirizzo della struttura VDS_VOLUME_PROP2 allocata e passata dal chiamante. VDS alloca memoria per la stringa membro pwszName . I chiamanti devono liberare la stringa usando la funzione CoTaskMemFree .

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
S_OK
Metodo completato correttamente.
VDS_S_PROPERTIES_INCOMPLETE
0x00042715L
Alcune proprietà, ma non tutte, sono state recuperate correttamente. Si noti che esistono molti possibili motivi per cui non è possibile recuperare tutte le proprietà, inclusa la rimozione del dispositivo.

Commenti

Questo metodo recupera l'identificatore univoco del volume per un volume. La struttura che contiene tale identificatore è VDS_VOLUME_PROP2, non VDS_VOLUME_PROP.

Si noti che un identificatore di volume univoco non corrisponde a un percorso GUID del volume. Per trovare i percorsi GUID del volume per un volume, usare il metodo IVdsVolumeMF3::QueryVolumeGuidPathnames .

Requisiti

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

Vedi anche

IVdsVolume2