GetStorageDependencyInformation, fonction (virtdisk.h)

Article
03/06/2024

Retourne les relations entre les disques durs virtuels (VHD) ou les fichiers image DE CD ou DVD (ISO) ou les volumes contenus dans ces disques et leur disque ou volume parent.

Syntaxe

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
);

Paramètres

[in] ObjectHandle

Handle vers un volume ou un répertoire racine si le paramètre Flags ne spécifie pas l’indicateur GET_STORAGE_DEPENDENCY_FLAG_DISK_HANDLE . Pour plus d’informations sur l’ouverture d’un volume ou d’un répertoire racine, consultez la fonction CreateFile .

Si le paramètre Flags spécifie l’indicateur GET_STORAGE_DEPENDENCY_FLAG_DISK_HANDLE , ce handle doit être un handle pour un disque.

[in] Flags

Combinaison valide de valeurs GET_STORAGE_DEPENDENCY_FLAG .

[in] StorageDependencyInfoSize

Taille, en octets, de la mémoire tampon à laquelle le paramètre StorageDependencyInfo fait référence.

[in, out] StorageDependencyInfo

Pointeur vers une mémoire tampon pour recevoir la structure STORAGE_DEPENDENCY_INFO renseignée, qui est une structure de longueur variable.

[in, out, optional] SizeUsed

Pointeur facultatif vers un ULONG qui reçoit la taille utilisée.

Valeur retournée

Statut de la demande.

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS et le paramètre StorageDependencyInfo contient les informations de dépendance demandées.

Si la fonction échoue, la valeur de retour est un code d’erreur et le paramètre StorageDependencyInfo n’est pas défini. Pour plus d’informations, consultez Codes d’erreur système.

Remarques

Les fichiers image CD et DVD (ISO) ne sont pas pris en charge avant Windows 8 et Windows Server 2012.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7
Serveur minimal pris en charge	Windows Server 2008 R2
Plateforme cible	Windows
En-tête	virtdisk.h
Bibliothèque	VirtDisk.lib
DLL	VirtDisk.dll

Voir aussi

À propos du disque dur virtuel

Référence du disque dur virtuel

Partager via