Metodo IVdsIscsiTarget::GetProperties (vds.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 una destinazione iSCSI.

Sintassi

HRESULT GetProperties(
  [out] VDS_ISCSI_TARGET_PROP *pTargetProp
);

Parametri

[out] pTargetProp

Indirizzo di una struttura VDS_ISCSI_TARGET_PROP allocata dal chiamante. VDS alloca memoria per le stringhe a cui puntano i membri pwszIscsiName e pwszFriendlyName di questa struttura. 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 restituite 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 portal non è più presente.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione vds.h
Libreria Uuid.lib
Componente ridistribuibile VDS 1.1

Vedi anche

IVdsIscsiTarget

VDS_ISCSI_TARGET_PROP