Metodo IVdsDisk3::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 un disco. Questo metodo è identico al metodo IVdsDisk::GetProperties , ad eccezione del fatto che restituisce una struttura VDS_DISK_PROP2 anziché una struttura VDS_DISK_PROP .
Sintassi
HRESULT GetProperties2(
[out] VDS_DISK_PROP2 *pDiskProperties
);
Parametri
[out] pDiskProperties
Indirizzo della struttura VDS_DISK_PROP2 allocata e passata dal chiamante. VDS alloca memoria per le stringhe membro pwszDiskAddress, pwszName, pwszFriendlyName, pwszAdaptorName, pwszDevicePath e pwszLocationPath. I chiamanti devono liberare le stringhe 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 derivare da VDS stesso o dal provider VDS sottostante usato. I valori restituiti possibili includono quanto segue.
| Codice/valore restituito | Descrizione |
|---|---|
|
Le proprietà sono state restituite correttamente. |
|
Alcune proprietà, ma non tutte le proprietà sono state recuperate correttamente. Si noti che esistono molti possibili motivi per la mancata recupero di tutte le proprietà, inclusa la rimozione del dispositivo. |
Commenti
Nella struttura VDS_DISK_PROP2 restituita nel parametro pDiskProperties , il membro pwszDiskAddress è facoltativo e può essere NULL se non è disponibile alcun valore. I chiamanti di questo metodo devono verificare se questo membro è NULL.
Per Hyper-V, il membro pwszLocationPath è NULL, perché il controller virtuale non restituisce il percorso del percorso.
Requisiti
| 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 |