IVdsLunMpio::GetLoadBalancePolicy-Methode (vds.h)
[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API abgelöst.]
Gibt die aktuelle Lastenausgleichsrichtlinie für die LUN zurück.
Syntax
HRESULT GetLoadBalancePolicy(
[out] VDS_LOADBALANCE_POLICY_ENUM *pPolicy,
[out] VDS_PATH_POLICY **ppPaths,
[out] LONG *plNumberOfPaths
);
Parameter
[out] pPolicy
Ein Zeiger auf eine Variable, die einen VDS_LOADBALANCE_POLICY_ENUM Enumerationswert empfängt, der die Lastenausgleichsrichtlinie angibt.
[out] ppPaths
Ein Zeiger auf das Array von VDS_PATH_POLICY Strukturen, die vom Aufrufer übergeben werden. Aufrufer müssen dieses Array mithilfe der Funktion CoTaskMemFree freigeben.
[out] plNumberOfPaths
Ein Zeiger auf eine Variable, die die Anzahl der pfadspezifischen Richtlinieninformationsstrukturen empfängt, die im ppPaths-Parameter 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 makros HRESULT_FROM_WIN32 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 Richtlinie für den Lastenausgleich wurde erfolgreich zurückgegeben. Wenn die LUN keine Pfade enthält, ist das Array leer, der Wert, auf den der parameter plNumberOfPaths verweist, wird auf 0 festgelegt, und der Wert, auf den der ppPaths-Parameter verweist, wird auf NULL festgelegt. |
|
Der Cache des Anbieters ist beschädigt. Dies weist auf ein Software- oder Kommunikationsproblem innerhalb eines Anbieters hin, 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 weist einen Fehlerstatus auf und kann den angeforderten Vorgang nicht ausführen. |
|
Ein weiterer Vorgang wird ausgeführt. Dieser Vorgang kann erst fortgesetzt werden, wenn vorherige Vorgänge abgeschlossen sind. |
Hinweise
Die Anzahl der von dieser Methode zurückgegebenen Pfade entspricht der Anzahl der Pfade, die von der IVdsLunMpio::GetPathInfo-Methode zurückgegeben werden.
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 | vds.h |