Método IVdsService::QueryDriveLetters (vds.h)

Artigo
03/08/2023

[Começando com Windows 8 e Windows Server 2012, a interface COM do Serviço de Disco Virtual é substituída pela API de Gerenciamento de Armazenamento do Windows.]

Retorna detalhes da propriedade para um conjunto de letras de unidade.

Sintaxe

HRESULT QueryDriveLetters(
  [in]  WCHAR                 wcFirstLetter,
  [in]  DWORD                 count,
  [out] VDS_DRIVE_LETTER_PROP *pDriveLetterPropArray
);

Parâmetros

[in] wcFirstLetter

A primeira letra da unidade a ser recuperada.

[in] count

O número total de letras de unidade a serem recuperadas.

[out] pDriveLetterPropArray

O endereço de uma matriz de estruturas VDS_DRIVE_LETTER_PROP . O tamanho da matriz é count. Os chamadores devem alocar a memória para essa matriz.

Retornar valor

Esse método pode retornar valores HRESULT padrão, como E_INVALIDARG ou E_OUTOFMEMORY, e valores retornados específicos do VDS. Ele também pode retornar códigos de erro do sistema convertidos usando a macro HRESULT_FROM_WIN32 . Os erros podem se originar do próprio VDS ou do provedor de VDS subjacente que está sendo usado. Os possíveis valores retornados incluem o seguinte.

Retornar código/valor	Descrição
S_OK	O método foi concluído com sucesso.
VDS_E_INITIALIZED_FAILED 0x80042401L	Falha ao inicializar o VDS. Se um aplicativo chamar esse método antes que o serviço termine de inicializar, o método será bloqueado até que a inicialização seja concluída. Se a inicialização falhar, esse erro será retornado.

Requisitos


Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	vds.h
Biblioteca	Uuid.lib

Confira também

IVdsService

VDS_DRIVE_LETTER_PROP

Compartilhar via