Método IVdsVolumeMF::D eleteAccessPath (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.]
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 |
|---|---|
|
O método foi concluído com sucesso. |
|
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. |
|
O caminho especificado não foi encontrado. |
|
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. |
|
O volume falhou. |
|
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 |