Share via

Metodo IVdsDrive::SetStatus (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.

Imposta lo stato dell'unità sul valore specificato.

Sintassi

HRESULT SetStatus(
  [in] VDS_DRIVE_STATUS status
);

Parametri

[in] status

Valori enumerati da VDS_DRIVE_STATUS. I chiamanti possono passare un subset dei valori di enumerazione possibili. Il passaggio VDS_DRS_UNKNOWN restituisce E_INVALIDARG.

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
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 drive non è più presente.
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
 L'unità si trova in uno stato non riuscito e non è in grado di eseguire l'operazione richiesta.
VDS_E_ANOTHER_CALL_IN_PROGRESS
0x80042404L
 Un'altra operazione è in corso; questa operazione non può continuare fino al completamento dell'operazione o delle operazioni precedenti.
VDS_E_NOT_SUPPORTED
0x80042400L
 Questa operazione o combinazione di parametri non è supportata da questo provider.

Commenti

Gli implementatori sono responsabili dell'esecuzione di tutte le operazioni necessarie per ottenere lo stato specificato. Ad esempio, se il chiamante passa VDS_DRS_OFFLINE come stato dell'unità, potrebbe essere necessario cancellare prima la cache.

Requisiti

   
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

IVdsDrive

IVdsHwProvider::Reenumerate

IVdsHwProvider::Refresh

VDS_DRIVE_STATUS