Método AddAccessPath da classe MSFT_Partition

Adiciona um caminho de montagem ou atribuição de letra da unidade à partição.

Sintaxe

UInt32 AddAccessPath(
  [in]  String  AccessPath,
  [in]  Boolean AssignDriveLetter,
  [out] String  ExtendedStatus
);

Parâmetros

AccessPath [in]

Especifica o caminho de acesso, que é um caminho de modo de usuário que pode ser usado para abrir a partição. Um caminho de acesso pode ser uma letra da unidade (por exemplo, "C:" ou "C:\") ou um caminho para um diretório vazio em um volume NTFS. A cadeia de caracteres do caminho de acesso não requer uma barra invertida à direita.

AssignDriveLetter [in]

Se TRUE, a próxima letra da unidade disponível será atribuída à partição.

ExtendedStatus [out]

Uma cadeia de caracteres que contém um objeto MSFT_StorageExtendedStatus inserido.

Esse parâmetro permite que o provedor de armazenamento retorne informações de erro estendidas (específicas da implementação).

Retornar valor

Êxito (0)

Sem suporte (1)

Erro não especificado (2)

Tempo limite (3)

Falha (4)

Parâmetro inválido (5)

Acesso negado (40001)

Não há recursos suficientes para concluir a operação. (40002)

O caminho de acesso solicitado já está em uso. (42002)

Não é possível atribuir caminhos de acesso a partições ocultas. (42004)

O caminho de acesso não é válido. (42007)

Comentários

Esse método adiciona um caminho de montagem ou atribuição de letra de unidade à partição. Os parâmetros AccessPath e AssignDriveLetter são mutuamente exclusivos e resultarão em um erro de parâmetro inválido se ambos forem especificados ao mesmo tempo. Esse método 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 partições formatadas em NTFS. Esse método retornará um erro se o caminho especificado em AccessPath for uma pasta que já está em uso (mesmo que o diretório esteja vazio) ou se contiver um caminho para um diretório não vazio.

Requisitos

Confira também

MSFT_Partition