Metodo IVdsControllerPort::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.

Recupera le proprietà di una porta controller.

Sintassi

HRESULT GetProperties(
  [out] VDS_PORT_PROP *pPortProp
);

Parametri

[out] pPortProp

Indirizzo di un membro della struttura VDS_PORT_PROP allocata e passata dal chiamante. VDS alloca memoria per le stringhe 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 derivare da VDS stesso o dal provider VDS sottostante usato. I valori restituiti possibili includono quanto segue.

Codice/valore restituito Descrizione
S_OK
 Le proprietà sono state recuperate correttamente.
VDS_S_PROPERTIES_INCOMPLETE
0x00042715L
 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.
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
 La cache del provider è danneggiata. Ciò indica un problema di comunicazione o software all'interno di un provider che memorizza nella cache le informazioni sui dispositivi collegati. Il chiamante può usare il metodo IVdsHwProvider::Reenumerate seguito dal metodo IVdsHwProvider ::Refresh per ripristinare la cache.
VDS_E_OBJECT_DELETED
0x8004240BL
 L'oggetto porta controller non è più presente.

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione vdshwprv.h

Vedi anche

IVdsControllerPort

VDS_PORT_PROP