Metodo IVdsIscsiTarget::D elete (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.

Elimina la destinazione e tutti i relativi gruppi di portale se non sono associati lun alla destinazione.

Sintassi

HRESULT Delete(
  [out] IVdsAsync **ppAsync
);

Parametri

[out] ppAsync

Indirizzo di un puntatore dell'interfaccia IVdsAsync , che il VDS inizializza sul ritorno. I chiamanti devono rilasciare l'interfaccia. Usare questa interfaccia per annullare, attendere o eseguire query sullo stato dell'operazione. Se si chiama il metodo IVdsAsync::Wait in questa interfaccia e viene restituito un valore HRESULT riuscito, è necessario rilasciare le interfacce restituite nella struttura VDS_ASYNC_OUTPUT chiamando il metodo IUnknown::Release in ogni puntatore dell'interfaccia. Tuttavia, se Wait restituisce un valore HRESULT non riuscito o se il parametro pHrResultdiWait riceve un valore HRESULT non riuscito, i puntatori di interfaccia nella struttura VDS_ASYNC_OUTPUT sono NULL e non devono essere rilasciati. È possibile testare i valori HRESULT di esito positivo o negativo usando le macro SUCCESSED e FAILED definite in Winerror.h.

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
 Il gruppo del portale è stato creato correttamente.
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 di destinazione non è più presente.
VDS_E_ANOTHER_CALL_IN_PROGRESS
0x80042404L
 Un'altra operazione è in corso; questa operazione non può continuare fino al completamento delle operazioni precedenti.
VDS_E_ASSOCIATED_LUNS_EXIST
0x8004270BL
 Le LUN sono associate a questa destinazione. Tutte le LUN devono essere annullate da questa destinazione prima che questa destinazione possa essere eliminata.

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

IVdsAsync

IVdsIscsiTarget