Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API ersetzt.]
Gibt ein Array von VDS_PATH_INFO Strukturen zurück, eines für jeden Pfad zur LUN.
Syntax
HRESULT GetPathInfo(
[out] VDS_PATH_INFO **ppPaths,
[out] LONG *plNumberOfPaths
);
Parameter
[out] ppPaths
Die Adresse einer Variablen, die ein Array von VDS_PATH_INFO Strukturen empfängt. Aufrufer müssen jedes Element im Array und das Array selbst mithilfe der CoTaskMemFree-Funktion freigeben.
[out] plNumberOfPaths
Die Adresse einer Variablen, die die Anzahl der Elemente im Array empfängt, die im ppPaths-Parameter zurückgegeben werden.
Die Anzahl der von dieser Methode zurückgegebenen Pfade entspricht der Anzahl von Pfaden, die von der IVdsLunMpio::GetLoadBalancePolicy-Methode zurückgegeben werden.
Rückgabewert
Diese Methode kann HRESULT-Standardwerte wie E_INVALIDARG oder E_OUTOFMEMORY und VDS-spezifische Rückgabewerte zurückgeben. Es kann auch konvertierte Systemfehlercodes mithilfe des HRESULT_FROM_WIN32-Makros zurückgeben. Fehler können vom VDS selbst oder vom zugrunde liegenden VDS-Anbieter stammen, der verwendet wird. Folgende Rückgabewerte sind möglich.
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Die Pfadinformationen wurden erfolgreich zurückgegeben. |
|
Der Cache des Anbieters ist beschädigt. Dies gibt ein Software- oder Kommunikationsproblem innerhalb eines Anbieters an, der Informationen zu den angefügten Geräten zwischenspeichert. Der Aufrufer kann die IVdsHwProvider::Reenumerate-Methode gefolgt von der IVdsHwProvider::Refresh-Methode verwenden, um den Cache wiederherzustellen. |
|
Das LUN-Objekt ist nicht mehr vorhanden. |
|
Die LUN ist fehlerhaft und kann den angeforderten Vorgang nicht ausführen. |
|
Ein weiterer Vorgang wird ausgeführt. Dieser Vorgang kann erst fortgesetzt werden, wenn die vorherigen Vorgänge abgeschlossen sind. |
Hinweise
Hardwareanbieter müssen die VDS_OBJECT_ID nicht bei hbaPortProp.id VDS_PATH_INFO zurückgeben und sollten dies einfach auf GUID_NULL festlegen. Diese ID wird vom System eingegeben, wenn dieser Aufruf an Anwendungen zurückgegeben wird. Wenn der Dienst den entsprechenden HBA-Port nicht finden kann, wird GUID_NULL verwendet. Die Anwendung interpretiert dies so, dass der HBA-Port für VDS unbekannt ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vdshwprv.h |
| Bibliothek | Uuid.lib |
| Verteilbare Komponente | VDS 1.1 |