Função CreateBindLink (bindlink.h)

Essa API permite que os administradores criem um link de associação entre um caminho virtual e um caminho de backup. O caminho virtual é sempre local, enquanto o caminho de backup pode ser local ou remoto (um compartilhamento de rede, por exemplo). O pai do virtualPath deve estar visível para que a criação do link seja bem-sucedida. O caminho virtual e o caminho de backup podem representar arquivos ou diretórios. O backingPath para um link anterior também pode ser um virtualPath para um link subsequente. CreateBindLink só pode ser chamado por um usuário com privilégios de Administrador. Depois de criado, um link de associação existe em todo o sistema e dura até ser excluído chamando RemoveBindLink ou até que o sistema seja desligado.

Sintaxe

HRESULT CreateBindLink(
  PCWSTR                 virtualPath,
  PCWSTR                 backingPath,
  CREATE_BIND_LINK_FLAGS createBindLinkFlags,
  UINT32                 exceptionCount,
  PCWSTR * const         exceptionPaths
);

Parâmetros

virtualPath

O caminho virtual a ser usado para criar o link de associação.

backingPath

O caminho de backup a ser usado para criar o link de associação.

createBindLinkFlags

Esses sinalizadores podem alterar o comportamento de vínculo de associação padrão para atender às necessidades do usuário. Consulte CREATE_BIND_LINK_FLAGS para obter mais detalhes.

exceptionCount

O número de exceções fornecidas no parâmetro exceptionPaths .

exceptionPaths

Os caminhos de exceção a serem excluídos do link de associação. Observe que as exceções não se aplicam a links sem âncora, pois os caminhos virtuais sem âncora não têm descendentes por definição e, portanto, não têm caminhos qualificados. A API retornará um erro se houver uma tentativa de passar exceções para o link sem âncora.

Comentários

Para obter mais informações sobre como criar links de associação, consulte Visão geral do Bindlink – Criando links de associação.

Exemplos

Para obter um exemplo completo de como usar as APIs CreateBindLink e RemoveBindLink , consulte a página de exemplo de link de associação .

Requisitos

Confira também

RemoveBindLink