Compartilhar via

Método IVdsVolumeMF::D eleteAccessPath (vds.h)

  • Artigo

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

Remove o caminho de acesso do volume atual.

Sintaxe

HRESULT DeleteAccessPath(
  [in] LPWSTR pwszPath,
  [in] BOOL   bForce
);

Parâmetros

[in] pwszPath

Uma cadeia de caracteres que contém o caminho de acesso a ser removido. Um caminho de acesso pode ser uma letra da unidade ou um caminho para um diretório vazio em um volume NTFS. Se for uma letra de unidade, você deverá incluir uma barra invertida à direita, por exemplo, "F:". Se for um caminho para um diretório, a barra invertida à direita não será necessária, por exemplo, "C:\MyFolder\MyDocuments".

[in] bForce

Se TRUE, o caminho de acesso será excluído incondicionalmente, mesmo que o volume esteja em uso. Esse parâmetro só é significativo quando o caminho de acesso é uma letra da unidade.

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.

Código/valor de retorno Descrição
S_OK
 O método foi concluído com sucesso.
VDS_E_OPERATION_DENIED
0x8004240AL
 O caminho leva ao volume do sistema, ao volume de inicialização, ao volume de crashdump, ao volume de hibernação ou ao volume pagefile. Não é possível remover a letra da unidade desses volumes.
VDS_E_PATH_NOT_FOUND
0x80042416L
 O caminho especificado não foi encontrado.
VDS_E_DEVICE_IN_USE
0x80042413L
 O caminho de acesso foi excluído com êxito, no entanto, ocorreu um erro. O VDS possivelmente falhou ao atualizar o atributo GPT (tabela de partição GUID) de uma partição ou não conseguiu excluir um compartilhamento de rede padrão (como F$) ao excluir a letra da unidade.
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

Se não houver identificadores abertos no volume, a letra da unidade será removida imediatamente. No entanto, se houver identificadores abertos no volume, o volume não poderá ser bloqueado e a letra da unidade será removida quando o computador for reiniciado.

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

IVdsVolumeMF::AddAccessPath

IVdsVolumeMF::QueryAccessPaths