CreateBindLink-Funktion (bindlink.h)

Mit dieser API können Administratoren eine Bindungsverbindung zwischen einem virtuellen Pfad und einem Sicherungspfad erstellen. Der virtuelle Pfad ist immer lokal, während der Sicherungspfad lokal oder remote sein kann (z. B. eine Netzwerkfreigabe). Das übergeordnete Element des virtualPath sollte sichtbar sein, damit die Linkerstellung erfolgreich ist. Sowohl der virtuelle Pfad als auch der Sicherungspfad können Dateien oder Verzeichnisse darstellen. Der BackingPath für einen vorherigen Link kann auch ein virtualPath für einen nachfolgenden Link sein. CreateBindLink kann nur von einem Benutzer mit Administratorrechten aufgerufen werden. Nach der Erstellung ist ein Bindungslink systemweit vorhanden und dauert, bis er durch Aufrufen von RemoveBindLink gelöscht wird oder das System heruntergefahren wird.

Syntax

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

Parameter

virtualPath

Der virtuelle Pfad, der zum Erstellen des Bindungslinks verwendet werden soll.

backingPath

Der Sicherungspfad, der zum Erstellen des Bindungslinks verwendet werden soll.

createBindLinkFlags

Diese Flags können das Standardverhalten von Bindungslinks entsprechend den Anforderungen des Benutzers ändern. Weitere Informationen finden Sie unter CREATE_BIND_LINK_FLAGS .

exceptionCount

Die Anzahl von Ausnahmen, die im exceptionPaths-Parameter bereitgestellt werden.

exceptionPaths

Die Ausnahmepfade, die vom Bindungslink ausgeschlossen werden sollen. Beachten Sie, dass Ausnahmen nicht für Ankerlinks gelten, da ankerlose virtuelle Pfade per Definition keine Nachfolger haben und daher keine geeigneten Pfade haben. Die API gibt einen Fehler zurück, wenn versucht wird, Ausnahmen an einen ankerlosen Link zu übergeben.

Hinweise

Weitere Informationen zum Erstellen von Bindungslinks finden Sie unter Übersicht über Bindlinks – Erstellen von Bindungslinks.

Beispiele

Ein vollständiges Beispiel für die Verwendung der CreateBindLink - und RemoveBindLink-APIs finden Sie auf der Beispielseite für Bindungslinks .

Anforderungen

Anforderung	Wert
Header	bindlink.h
Bibliothek	bindlink.lib
DLL	bindlink.dll

Weitere Informationen

RemoveBindLink