Funzione CreateBindLink (bindlink.h)
Questa API consente agli amministratori di creare un collegamento di associazione tra un percorso virtuale e un percorso di backup. Il percorso virtuale è sempre locale mentre il percorso di backup potrebbe essere locale o remoto (ad esempio una condivisione di rete). L'elemento padre di VirtualPath deve essere visibile per la creazione del collegamento. Sia il percorso virtuale che il percorso di backup possono rappresentare file o directory. Il backingPath per un collegamento precedente può essere anche un percorso virtuale per un collegamento successivo. CreateBindLink può essere chiamato solo da un utente con privilegi di amministratore. Dopo aver creato, un collegamento di associazione esiste a livello di sistema e dura fino a quando non viene eliminato chiamando RemoveBindLink o finché il sistema non viene arrestato.
Sintassi
HRESULT CreateBindLink(
PCWSTR virtualPath,
PCWSTR backingPath,
CREATE_BIND_LINK_FLAGS createBindLinkFlags,
UINT32 exceptionCount,
PCWSTR * const exceptionPaths
);
Parametri
virtualPath
Percorso virtuale da usare per creare il collegamento di associazione.
backingPath
Percorso di backup da usare per creare il collegamento di associazione.
createBindLinkFlags
Questi flag possono modificare il comportamento predefinito del collegamento di associazione in base alle esigenze dell'utente. Per altre informazioni, vedere CREATE_BIND_LINK_FLAGS .
exceptionCount
Numero di eccezioni fornite nel parametro exceptionPaths .
exceptionPaths
Percorsi di eccezione da escludere dal collegamento di associazione. Si noti che le eccezioni non si applicano ai collegamenti senza ancoraggi poiché i percorsi virtuali senza ancoraggio non hanno discendenti per definizione e, pertanto, non hanno percorsi idonei. L'API restituirà un errore se è presente un tentativo di passare eccezioni al collegamento senza ancoraggio.
Commenti
Per altre informazioni sulla creazione di collegamenti di associazione, vedere Panoramica di Bindlink - Creazione di collegamenti di associazione.
Esempio
Per un esempio completo di come usare le API CreateBindLink e RemoveBindLink , vedere la pagina dell'esempio di collegamento di associazione .
Requisiti
Requisito | Valore |
---|---|
Intestazione | bindlink.h |
Libreria | bindlink.lib |
DLL | bindlink.dll |