IVdsServiceUninstallDisk::GetDiskIdFromLunInfo-Methode (vds.h)

  • Artikel

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API ersetzt.]

Ruft die VDS-Objekt-ID für den Datenträger ab, der einer angegebenen LUN entspricht.

Syntax

HRESULT GetDiskIdFromLunInfo(
  [in]  VDS_LUN_INFORMATION *pLunInfo,
  [out] VDS_OBJECT_ID       *pDiskId
);

Parameter

[in] pLunInfo

Die Adresse einer VDS_LUN_INFORMATION Struktur, die von einem VDS-Hardwareanbieter initialisiert wurde.

[out] pDiskId

Die Adresse einer vom Aufrufer übergebenen VDS-Objekt-ID-Variablen. Diese Variable empfängt die GUID für den Datenträger, der der LUN entspricht.

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
S_OK
 Die GUID des Datenträgers wurde erfolgreich zurückgegeben.
VDS_E_NO_DISK_PATHNAME
0x8004270FL
 Der Pfad des Datenträgers konnte nicht abgerufen werden. Bei einigen Vorgängen auf dem Datenträger kann ein Fehler auftreten.
VDS_E_OBJECT_NOT_FOUND
0x80042405L
 Der Datenträger wurde nicht gefunden.

Hinweise

VDS implementiert diese Methode. Diese Methode wird von VDS-Anwendungen aufgerufen, die einen Datenträger deinstallieren müssen, auf dessen LUN über einen VDS-Hardwareanbieter auf einem anderen Computer zugegriffen wird. Mit dieser Methode kann die Anwendung einen Datenträger auf einem Computer deinstallieren, der keinen Zugriff auf einen VDS-Hardwareanbieter hat und daher keine implizite Verknüpfung zwischen Datenträger und LUN herstellen kann.

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
Bibliothek Uuid.lib

Weitere Informationen

IVdsServiceUninstallDisk

VDS_LUN_INFORMATION