Metodo IVdsLunMpio::GetLoadBalancePolicy (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 i criteri di bilanciamento del carico correnti nel LUN.

Sintassi

HRESULT GetLoadBalancePolicy(
  [out] VDS_LOADBALANCE_POLICY_ENUM *pPolicy,
  [out] VDS_PATH_POLICY             **ppPaths,
  [out] LONG                        *plNumberOfPaths
);

Parametri

[out] pPolicy

Puntatore a una variabile che riceve un valore di enumerazione VDS_LOADBALANCE_POLICY_ENUM che specifica i criteri di bilanciamento del carico.

[out] ppPaths

Puntatore alla matrice di strutture VDS_PATH_POLICY passate dal chiamante. I chiamanti devono liberare questa matrice usando la funzione CoTaskMemFree .

[out] plNumberOfPaths

Puntatore a una variabile che riceve il numero di strutture di informazioni sui criteri specifiche del percorso restituite nel parametro ppPaths .

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
I criteri di bilanciamento del carico sono stati restituiti correttamente. Se il LUN non ha percorsi, la matrice è vuota, il valore a cui punta il parametro plNumberOfPaths è impostato su 0 e il valore a cui punta il parametro ppPaths è impostato su NULL.
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 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 delle operazioni precedenti.

Commenti

Il numero di percorsi restituiti da questo metodo corrisponderà al numero di percorsi restituiti dal metodo IVdsLunMpio::GetPathInfo .

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

IVdsLunMpio

IVdsLunMpio::GetLoadBalancePolicy

VDS_LOADBALANCE_POLICY_ENUM

VDS_PATH_POLICY