Condividi tramite


Metodo IVdsServiceHba::QueryHbaPorts (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 oggetto di enumerazione IEnumVdsObject contenente un elenco delle porte HBA note al VDS nel sistema locale.

Sintassi

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

Parametri

[out] ppEnum

Indirizzo di un puntatore all'interfaccia IEnumVdsObject che può essere usato per enumerare le porte HBA come oggetti porta HBA. Per altre informazioni, vedere Utilizzo degli oggetti di enumerazione. I chiamanti devono rilasciare l'interfaccia e ognuno degli oggetti porta HBA 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 HBA è stata restituita correttamente. Se il sistema locale non ha porte HBA, l'enumerazione è vuota.
VDS_E_INITIALIZED_FAILED
0x80042401L
Impossibile inizializzare VDS. Se un'applicazione chiama questo metodo prima che il servizio VDS completi l'inizializzazione, il metodo viene bloccato fino al completamento dell'inizializzazione. Se l'inizializzazione ha esito negativo, viene restituito questo errore.

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

Vedi anche

IEnumVdsObject

IVdsServiceHba