Função GetStorageDependencyInformation (virtdisk.h)

Retorna as relações entre VHDs (discos rígidos virtuais) ou ISO (arquivo de imagem de CD ou DVD) ou os volumes contidos nesses discos e seu disco ou volume pai.

Sintaxe

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

Parâmetros

[in] ObjectHandle

Um identificador para um volume ou diretório raiz se o parâmetro Flags não especificar o sinalizador GET_STORAGE_DEPENDENCY_FLAG_DISK_HANDLE . Para obter informações sobre como abrir um diretório raiz ou volume, consulte a função CreateFile .

Se o parâmetro Flags especificar o sinalizador GET_STORAGE_DEPENDENCY_FLAG_DISK_HANDLE , esse identificador deverá ser um identificador para um disco.

[in] Flags

Uma combinação válida de valores de GET_STORAGE_DEPENDENCY_FLAG .

[in] StorageDependencyInfoSize

Tamanho, em bytes, do buffer ao qual o parâmetro StorageDependencyInfo se refere.

[in, out] StorageDependencyInfo

Um ponteiro para um buffer para receber a estrutura de STORAGE_DEPENDENCY_INFO preenchida, que é uma estrutura de comprimento variável.

[in, out, optional] SizeUsed

Um ponteiro opcional para um ULONG que recebe o tamanho usado.

Retornar valor

Status da solicitação.

Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS e o parâmetro StorageDependencyInfo conterá as informações de dependência solicitadas.

Se a função falhar, o valor retornado será um código de erro e o parâmetro StorageDependencyInfo será indefinido. Para obter mais informações, consulte Códigos de erro do sistema.

Comentários

Não há suporte para ISO (arquivos de imagem de CD e DVD) antes de Windows 8 e Windows Server 2012.

Requisitos

Confira também

Sobre o VHD

Referência de VHD