Функция CreateBindLink (bindlink.h)

  • Статья

Этот API позволяет администраторам создавать связь привязки между виртуальным и резервным путем. Виртуальный путь всегда является локальным, а резервный путь может быть локальным или удаленным (например, сетевая папка). Родительский элемент virtualPath должен быть виден для успешного создания ссылки. Виртуальный и резервный путь могут представлять файлы или каталоги. BackingPath для предыдущей ссылки также может быть virtualPath для последующей ссылки. Метод CreateBindLink может вызываться только пользователем с правами администратора. После создания связь привязки существует на уровне системы и продолжается до удаления путем вызова RemoveBindLink или до завершения работы системы.

Синтаксис

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

Параметры

virtualPath

Виртуальный путь, используемый для создания связи привязки.

backingPath

Резервный путь, используемый для создания ссылки привязки.

createBindLinkFlags

Эти флаги могут изменить поведение ссылки привязки по умолчанию в соответствии с потребностями пользователя. Дополнительные сведения см . в CREATE_BIND_LINK_FLAGS.

exceptionCount

Количество исключений, указанных в параметре exceptionPaths .

exceptionPaths

Пути исключений, которые должны быть исключены из ссылки привязки. Обратите внимание, что исключения не применяются к ссылкам без привязки, так как виртуальные пути без привязки по определению не имеют потомков и, следовательно, не имеют путей, которые соответствуют требованиям. API вернет ошибку при попытке передать исключения в связь без привязки.

Комментарии

Дополнительные сведения о создании ссылок привязки см. в разделе Общие сведения о привязке ссылок — создание ссылок привязки.

Примеры

Полный пример использования API CreateBindLink и RemoveBindLink см. на странице примеров ссылок привязки .

Требования

Требование Значение
Заголовок bindlink.h
Библиотека bindlink.lib
DLL bindlink.dll

См. также раздел

RemoveBindLink