Metodo IVdsLun2::QueryHints2 (vds.h)

Articolo
03/08/2023

[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 gli hint attualmente applicati al LUN. Questo metodo è identico al metodo IVdsLun::QueryHints , ad eccezione del fatto che usa una struttura VDS_HINTS2 anziché una struttura VDS_HINTS .

Sintassi

HRESULT QueryHints2(
  [out] VDS_HINTS2 *pHints2
);

Parametri

[out] pHints2

Puntatore agli hint LUN restituiti. Vedere la struttura VDS_HINTS2 .

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	Si verifica 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 LUN non è più presente.
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	Il LUN è 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

I chiamanti possono specificare hint passando il parametro pHints2 al metodo IVdsSubSystem2::CreateLun2 quando si crea un LUN o usando il metodo IVdsLun2::ApplyHints2 per applicare un set di nuovi hint a un LUN esistente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vds.h
Libreria	Uuid.lib