Compartilhar via


Método IVdsVolumeMF::AddAccessPath (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.]

Adiciona um caminho de acesso.

Sintaxe

HRESULT AddAccessPath(
  [in] LPWSTR pwszPath
);

Parâmetros

[in] pwszPath

Uma cadeia de caracteres que indica o caminho de acesso, que é um caminho de modo de usuário que pode ser usado para abrir o volume. Um caminho de acesso pode ser uma letra de unidade ou um caminho para um diretório vazio em um volume NTFS. A cadeia de caracteres de caminho de acesso deve incluir uma barra invertida à direita, por exemplo, "F:".

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 caminho foi adicionado com êxito.
S_FALSE
No entanto, o caminho de acesso foi adicionado com êxito. O VDS possivelmente não conseguiu atualizar o atributo GPT_BASIC_DATA_ATTRIBUTE_NO_DRIVE_LETTER de uma partição ou não adicionou um compartilhamento de rede padrão (como F$) ao adicionar a letra da unidade. Para obter mais informações, consulte PARTITION_INFORMATION_GPT.
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
O volume falhou.
VDS_E_PACK_OFFLINE
0x80042444L
O pacote que contém o volume não está acessível.

Comentários

O VDS adiciona o caminho de acesso criando uma pasta montada (também chamada de ponto de montagem de volume). Observe que as pastas montadas têm suporte apenas em volumes NTFS. Para obter mais informações, consulte Pastas montadas.

Esse método retornará ERROR_DIR_NOT_EMPTY se o parâmetro pwszPath contiver um caminho para uma pasta montada que já esteja em uso (mesmo que o diretório esteja vazio) ou se pwszPath contiver um caminho para um diretório não vazio.

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

IVdsVolumeMF

SetVolumeMountPoint