Metodo IVdsController::SetStatus (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.]
Imposta lo stato di un controller sul valore specificato.
Sintassi
HRESULT SetStatus(
[in] VDS_CONTROLLER_STATUS status
);
Parametri
[in] status
Valori enumerati da VDS_CONTROLLER_STATUS. I chiamanti possono passare un subset dei possibili valori di enumerazione. Il passaggio di VDS_CS_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 provenire dal VDS stesso o dal provider VDS sottostante in uso. I valori restituiti possibili includono quanto segue.
| Codice/valore restituito | Descrizione |
|---|---|
|
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. |
|
L'oggetto controller non è più presente. |
|
Il controller si trova in uno stato di errore e non è in grado di eseguire l'operazione richiesta. |
|
Un'altra operazione è in corso; questa operazione non può continuare fino al completamento dell'operazione o delle operazioni precedenti. |
|
Questa operazione o combinazione di parametri non è supportata da questo provider. |
Commenti
Questo metodo consente di impostare lo stato di un singolo controller. È possibile impostare lo stato di tutti i controller in un sottosistema contemporaneamente chiamando il metodo IVdsSubSystem::SetControllerStatus . Utilizzare il metodo IVdsController::GetProperties per ottenere lo stato corrente del controller.
Gli implementatori sono responsabili dell'esecuzione di tutte le operazioni necessarie per ottenere lo stato specificato. Ad esempio, se il chiamante passa VDS_CS_OFFLINE come stato del controller, potrebbe essere necessario prima cancellare la cache per il controller.
Requisiti
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | vds.h |
| Libreria | Uuid.lib |