Metodo IVdsController::GetProperties (vdshwprv.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 le proprietà di un controller.

Sintassi

HRESULT GetProperties(
  [out] VDS_CONTROLLER_PROP *pControllerProp
);

Parametri

[out] pControllerProp

Indirizzo di una struttura VDS_CONTROLLER_PROP allocata e passata dal chiamante. VDS alloca memoria per le stringhe membro pwszFriendlyName e pwszIdentification . 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 provenire dal VDS stesso o dal provider VDS sottostante in uso. I valori restituiti possibili includono quanto segue.

Codice/valore restituito Descrizione
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.
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
 Questo valore restituito segnala un problema di comunicazione o software all'interno di un provider che memorizza nella cache le informazioni sulla matrice. Usare il metodo IVdsHwProvider::Reenumerate seguito dal metodo IVdsHwProvider::Refresh per ripristinare la cache.
VDS_E_OBJECT_DELETED
0x8004240BL
 L'oggetto controller non è più presente.

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 vdshwprv.h
Libreria Uuid.lib

Vedi anche

IVdsController

IVdsController::GetPortProperties

IVdsHwProvider::Reenumerate

IVdsHwProvider::Refresh

VDS_CONTROLLER_PROP