Metodo IVdsLunMpio::GetPathInfo (vdshwprv.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 una matrice di strutture VDS_PATH_INFO , una per ogni percorso del LUN.
Sintassi
HRESULT GetPathInfo(
[out] VDS_PATH_INFO **ppPaths,
[out] LONG *plNumberOfPaths
);
Parametri
[out] ppPaths
Indirizzo di una variabile che riceve una matrice di strutture VDS_PATH_INFO . I chiamanti devono liberare ogni elemento nella matrice e la matrice stessa usando la funzione CoTaskMemFree .
[out] plNumberOfPaths
Indirizzo di una variabile che riceve il numero di elementi nella matrice restituita nel parametro ppPaths .
Il numero di percorsi restituiti da questo metodo corrisponderà al numero di percorsi restituiti dal metodo IVdsLunMpio::GetLoadBalancePolicy .
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 |
|---|---|
|
Le informazioni sul percorso sono state restituite correttamente. |
|
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. |
|
L'oggetto LUN non è più presente. |
|
Il LUN è in uno stato non riuscito e non è in grado di eseguire l'operazione richiesta. |
|
Un'altra operazione è in corso. Questa operazione non può continuare fino al completamento delle operazioni precedenti. |
Commenti
I provider di hardware non devono restituire il VDS_OBJECT_ID in hbaPortProp.id di VDS_PATH_INFO e dovrebbe essere impostato su GUID_NULL. Questo ID verrà compilato dal sistema quando questa chiamata viene passata alle applicazioni. Se il servizio non riesce a trovare la porta HBA corrispondente, verrà usato GUID_NULL . L'applicazione interpreterà questa operazione per indicare che la porta HBA è sconosciuta a VDS.
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 | vdshwprv.h |
| Libreria | Uuid.lib |
| Componente ridistribuibile | VDS 1.1 |