Condividi tramite


Metodo IVdsLunControllerPorts::QueryActiveControllerPorts (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.]

Restituisce un'enumerazione delle porte controller attualmente attive, ovvero le porte del controller tramite cui è possibile accedere al LUN. Questo metodo sostituisce IVdsLun::QueryActiveControllers.

Sintassi

HRESULT QueryActiveControllerPorts(
  [out] IEnumVdsObject **ppEnum
);

Parametri

[out] ppEnum

Indirizzo di un puntatore all'interfaccia IEnumVdsObject che può essere usato per enumerare le porte del controller come oggetti porta controller. Per altre informazioni, vedere Utilizzo degli oggetti di enumerazione. I chiamanti devono rilasciare l'interfaccia e ognuno degli oggetti porta del controller quando non sono più necessari chiamando il metodo IUnknown::Release .

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
S_OK
L'enumerazione delle porte del controller è stata restituita correttamente. Se il LUN non ha porte controller attive, l'enumerazione è vuota.
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
La cache del provider è danneggiata. Questo 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 LUN non è più presente.
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
Il LUN si trova in uno stato di errore e non è in grado di eseguire l'operazione richiesta.
VDS_E_ANOTHER_CALL_IN_PROGRESS
0x80042404L
È in corso un'altra operazione. Questa operazione non può continuare fino al completamento delle operazioni precedenti.

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
Componente ridistribuibile VDS 1.1

Vedi anche

IVdsLun::QueryActiveControllers

IVdsLunControllerPorts