Funzione CreateSymbolicLinkTransactedW (winbase.h)
[Microsoft consiglia vivamente agli sviluppatori di usare mezzi alternativi per raggiungere le esigenze dell'applicazione. Molti scenari sviluppati da TxF possono essere ottenuti tramite tecniche più semplici e più leggibili. Inoltre, TxF potrebbe non essere disponibile nelle versioni future di Microsoft Windows. Per altre informazioni e alternative a TxF, vedere Alternative all'uso di NTFS transazionale.
Crea un collegamento simbolico come operazione transazionata.
Sintassi
BOOLEAN CreateSymbolicLinkTransactedW(
[in] LPCWSTR lpSymlinkFileName,
[in] LPCWSTR lpTargetFileName,
[in] DWORD dwFlags,
[in] HANDLE hTransaction
);
Parametri
[in] lpSymlinkFileName
Collegamento simbolico da creare.
[in] lpTargetFileName
Nome della destinazione per la creazione del collegamento simbolico.
Se lpTargetFileName ha un nome di dispositivo associato a esso, il collegamento viene considerato come collegamento assoluto; in caso contrario, il collegamento viene considerato come collegamento relativo.
[in] dwFlags
Indica se la destinazione del collegamento, lpTargetFileName, è una directory.
| Valore | Significato |
|---|---|
|
La destinazione del collegamento è un file. |
|
La destinazione del collegamento è una directory. |
[in] hTransaction
Handle per la transazione. Questo handle viene restituito dalla funzione CreateTransaction .
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
I collegamenti simbolici possono essere collegamenti assoluti o relativi. I collegamenti assoluti sono collegamenti che specificano ogni parte del nome del percorso; I collegamenti relativi vengono determinati in base al caso in cui gli identificatori di collegamento relativi si trovino in un percorso specificato. I collegamenti relativi vengono specificati usando le convenzioni seguenti:
- Convenzioni dot (. e ..), ad esempio ".. \" risolve il percorso relativo alla directory padre.
- I nomi senza barre (\\), ad esempio "tmp" risolvono il percorso relativo alla directory corrente.
- Radice relativa, ad esempio "\Windows\System32" si risolve in "unità corrente:\Windows\System32".
- Directory di lavoro corrente-relativa, ad esempio se la directory di lavoro corrente è C:\Windows\System32, "C:File.txt" viene risolta in "C:\Windows\System32\File.txt".
Nota Se si specifica un collegamento relativo alla directory di lavoro corrente, viene creato come collegamento assoluto, a causa del modo in cui la directory di lavoro corrente viene elaborata in base all'utente e al thread.
| Tecnologia | Supportato |
|---|---|
| Protocollo SMB (Server Message Block) 3.0 | No |
| Failover trasparente SMB 3.0 (TFO) | No |
| SMB 3.0 con condivisioni file con scalabilità orizzontale (SO) | No |
| File system del volume condiviso del cluster (CsvFS) | No |
| File system resiliente (ReFS) | No |
SMB 3.0 non supporta TxF.
Nota
L'intestazione winbase.h definisce CreateSymbolicLinkTransacted come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winbase.h (include Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |