Fonction CreateBindLink (bindlink.h)

Article
03/02/2024

Cette API permet aux administrateurs de créer un lien de liaison entre un chemin d’accès virtuel et un chemin de stockage. Le chemin d’accès virtuel est toujours local, tandis que le chemin d’accès de sauvegarde peut être local ou distant (un partage réseau, par exemple). Le parent du virtualPath doit être visible pour que la création du lien réussisse. Le chemin d’accès virtuel et le chemin de stockage peuvent représenter des fichiers ou des répertoires. Le backingPath d’un lien précédent peut également être un virtualPath pour un lien suivant. CreateBindLink ne peut être appelé que par un utilisateur disposant de privilèges d’administrateur. Une fois créé, un lien de liaison existe à l’échelle du système et il dure jusqu’à ce qu’il soit supprimé en appelant RemoveBindLink, ou jusqu’à ce que le système soit arrêté.

Syntaxe

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

Paramètres

virtualPath

Chemin d’accès virtuel à utiliser pour créer le lien de liaison.

backingPath

Chemin d’accès de stockage à utiliser pour créer le lien de liaison.

createBindLinkFlags

Ces indicateurs peuvent modifier le comportement des liens de liaison par défaut en fonction des besoins de l’utilisateur. Pour plus d’informations, consultez CREATE_BIND_LINK_FLAGS .

exceptionCount

Nombre d’exceptions fournies dans le paramètre exceptionPaths .

exceptionPaths

Chemins d’exception à exclure du lien de liaison. Notez que les exceptions ne s’appliquent pas aux liens sans ancre, car les chemins d’accès virtuels sans ancrage n’ont pas de descendants par définition et, par conséquent, n’ont pas de chemins d’accès éligibles. L’API retourne une erreur en cas de tentative de transmission d’exceptions à un lien sans ancre.

Remarques

Pour plus d’informations sur la création de liens de liaison, consultez Vue d’ensemble de Bindlink - Création de liens de liaison.

Exemples

Pour obtenir un exemple complet d’utilisation des API CreateBindLink et RemoveBindLink , consultez la page exemple de lien de liaison .

Configuration requise

Condition requise	Valeur
En-tête	bindlink.h
Bibliothèque	bindlink.lib
DLL	bindlink.dll

Voir aussi

RemoveBindLink

Partager via