Freigeben über


IVdsSubSystemImportTarget::GetImportTarget-Methode (vds.h)

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des virtuellen Datenträgerdiensts von der Windows Storage Management-API abgelöst.]

Gibt das Volume Shadow Copy Service (VSS)-Importziel für den Computer für dieses Subsystem zurück. Wenn Schattenkopien erstellt werden und eine LUN aus einem Schattenkopiesatz aus dem Subsystem auf diesen Computer importiert wird, wird sie dem Importziel vom VSS-Hardwareanbieter zugeordnet.

Syntax

HRESULT GetImportTarget(
  [out] LPWSTR *ppwszIscsiName
);

Die Parameter

[out] ppwszIscsiName

Die Adresse eines Zeigers auf eine Zeichenfolge. Bei erfolgreicher Rückgabe dieser Methode enthält die Zeichenfolge, auf die verwiesen wird, den iSCSI-Importzielnamen. Diese Zeichenfolge wird von VDS initialisiert und muss vom Aufrufer mithilfe der CoTaskMemFree-Funktion freigegeben werden.

Rückgabewert

Diese Methode kann HRESULT-Standardwerte wie E_INVALIDARG oder E_OUTOFMEMORY und VDS-spezifische Rückgabewerte zurückgeben. Sie kann auch konvertierte Systemfehlercodes mithilfe des HRESULT_FROM_WIN32 Makros zurückgeben. Fehler können von VDS selbst oder vom zugrunde liegenden VDS-Anbieter stammen, der verwendet wird. Mögliche Rückgabewerte sind:

Zurückgeben von Code/Wert Description
S_OK
Das Importziel wurde erfolgreich abgerufen.
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
Der Cache des Anbieters ist beschädigt. Dies weist auf ein Software- oder Kommunikationsproblem innerhalb eines Anbieters hin, der Informationen über die angeschlossenen Geräte zwischenspeichert. Der Aufrufer kann die IVdsHwProvider::Reenumerate-Methode gefolgt von der IVdsHwProvider::Refresh-Methode verwenden, um den Cache wiederherzustellen.
VDS_E_OBJECT_DELETED
0x8004240BL
Das Subsystemobjekt ist nicht mehr vorhanden.
VDS_E_NOT_SUPPORTED
0x80042400L
Der Vorgang oder die Kombination von Parametern wird von diesem Anbieter nicht unterstützt.
VDS_E_NO_IMPORT_TARGET
0x80042713L
Für dieses Subsystem wurde kein Importziel festgelegt.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows Vista [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2003 R2 [nur Desktop-Apps]
Zielplattform Fenster
Header vds.h
Library Uuid.lib
Weiterverteilbar VDS 1.1

Siehe auch

IVdsSubSystemImportTarget

SetImportTarget