Compartilhar via


Método IVdsAdvancedDisk::AssignDriveLetter (vds.h)

[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.]

Atribui uma letra de unidade a uma partição OEM, ESP ou desconhecida existente.

Sintaxe

HRESULT AssignDriveLetter(
  [in] ULONGLONG ullOffset,
  [in] WCHAR     wcLetter
);

Parâmetros

[in] ullOffset

O deslocamento de partição.

[in] wcLetter

A letra da unidade a ser atribuída.

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 ser originados do próprio VDS ou do provedor de VDS subjacente que está sendo usado. Os possíveis valores retornados incluem o seguinte.

Valor/código retornado Descrição
S_OK
A letra da unidade foi atribuída com êxito.
VDS_E_DRIVE_LETTER_NOT_FREE
0x8004255CL
A letra da unidade especificada já está atribuída a outra partição ou volume.
VDS_E_INVALID_OPERATION
0x80042415L
A partição está em uma mídia removível; caso contrário, a partição não é uma partição OEM, ESP ou desconhecida.
VDS_E_OBJECT_NOT_FOUND
0x80042405L
A partição não existe.

Comentários

O VDS implementa esse método.

Requisitos

Requisito Valor
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

Objeto Disk

IVdsAdvancedDisk