GetStorageDependencyInformation-Funktion (virtdisk.h)

Gibt die Beziehungen zwischen virtuellen Festplatten (VHDs) oder CD- oder DVD-Imagedatei (ISO) oder den Volumes zurück, die auf diesen Datenträgern und ihrem übergeordneten Datenträger oder Volume enthalten sind.

Syntax

DWORD GetStorageDependencyInformation(
  [in]                HANDLE                      ObjectHandle,
  [in]                GET_STORAGE_DEPENDENCY_FLAG Flags,
  [in]                ULONG                       StorageDependencyInfoSize,
  [in, out]           PSTORAGE_DEPENDENCY_INFO    StorageDependencyInfo,
  [in, out, optional] PULONG                      SizeUsed
);

Parameter

[in] ObjectHandle

Ein Handle für ein Volume oder Stammverzeichnis, wenn der Flags-Parameter das flag GET_STORAGE_DEPENDENCY_FLAG_DISK_HANDLE nicht angibt. Informationen zum Öffnen eines Volumes oder Stammverzeichnisses finden Sie in der CreateFile-Funktion .

Wenn der Flags-Parameter das GET_STORAGE_DEPENDENCY_FLAG_DISK_HANDLE Flag angibt, sollte dieses Handle ein Handle für einen Datenträger sein.

[in] Flags

Eine gültige Kombination aus GET_STORAGE_DEPENDENCY_FLAG Werten.

[in] StorageDependencyInfoSize

Größe des Puffers, auf den sich der Parameter StorageDependencyInfo bezieht.

[in, out] StorageDependencyInfo

Ein Zeiger auf einen Puffer zum Empfangen der aufgefüllten STORAGE_DEPENDENCY_INFO-Struktur , bei der es sich um eine Struktur mit variabler Länge handelt.

[in, out, optional] SizeUsed

Ein optionaler Zeiger auf eine ULONG , die die verwendete Größe empfängt.

Rückgabewert

Status der Anforderung.

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS und der Parameter StorageDependencyInfo enthält die angeforderten Abhängigkeitsinformationen.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Fehlercode, und der Parameter StorageDependencyInfo ist nicht definiert. Weitere Informationen finden Sie unter Systemfehlercodes.

Hinweise

CD- und DVD-Imagedateien (ISO) werden vor Windows 8 und Windows Server 2012 nicht unterstützt.

Anforderungen

Weitere Informationen

Informationen zu VHD

VHD-Referenz