Función CreateSymbolicLinkTransactedA (winbase.h)
[Microsoft recomienda encarecidamente que los desarrolladores usen medios alternativos para lograr las necesidades de la aplicación. Muchos escenarios para los que se desarrolló TxF se pueden lograr a través de técnicas más sencillas y disponibles con mayor facilidad. Además, es posible que TxF no esté disponible en versiones futuras de Microsoft Windows. Para obtener más información y alternativas a TxF, consulte Alternativas al uso de NTFS transaccional.]
Crea un vínculo simbólico como una operación de transacción.
Sintaxis
BOOLEAN CreateSymbolicLinkTransactedA(
[in] LPCSTR lpSymlinkFileName,
[in] LPCSTR lpTargetFileName,
[in] DWORD dwFlags,
[in] HANDLE hTransaction
);
Parámetros
[in] lpSymlinkFileName
Vínculo simbólico que se va a crear.
[in] lpTargetFileName
Nombre del destino del vínculo simbólico que se va a crear.
Si lpTargetFileName tiene un nombre de dispositivo asociado, el vínculo se trata como un vínculo absoluto; De lo contrario, el vínculo se trata como un vínculo relativo.
[in] dwFlags
Indica si el destino del vínculo, lpTargetFileName, es un directorio.
Valor | Significado |
---|---|
|
El destino del vínculo es un archivo. |
|
El destino del vínculo es un directorio. |
[in] hTransaction
Identificador de la transacción. El función createTransaction devuelve este identificador.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es distinto de cero.
Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.
Observaciones
Los vínculos simbólicos pueden ser vínculos absolutos o relativos. Los vínculos absolutos son vínculos que especifican cada parte del nombre de la ruta de acceso; los vínculos relativos se determinan en relación con dónde se encuentran los especificadores de vínculo relativos en una ruta de acceso especificada. Los vínculos relativos se especifican mediante las siguientes convenciones:
- Convenciones dot (. y ..), por ejemplo, ".. \" resuelve la ruta de acceso relativa al directorio primario.
- Nombres sin barras diagonales (\\): por ejemplo, "tmp" resuelve la ruta de acceso relativa al directorio actual.
- Relativo raíz: por ejemplo, "\Windows\System32" se resuelve en "unidad actual:\Windows\System32".
- Directorio de trabajo actual relativo, por ejemplo, si el directorio de trabajo actual es C:\Windows\System32, "C:File.txt" se resuelve en "C:\Windows\System32\File.txt".
Nota Si especifica un vínculo relativo al directorio de trabajo actual, se crea como un vínculo absoluto, debido a la forma en que se procesa el directorio de trabajo actual en función del usuario y del subproceso.
Tecnología | Soportado |
---|---|
Protocolo bloque de mensajes del servidor (SMB) 3.0 | No |
Conmutación por error transparente (TFO) de SMB 3.0 | No |
SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO) | No |
Sistema de archivos de volumen compartido de clúster (CsvFS) | No |
Sistema de archivos resistente (ReFS) | No |
SMB 3.0 no admite TxF.
Nota
El encabezado winbase.h define CreateSymbolicLinkTransacted como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
Requisito | Valor |
---|---|
cliente mínimo admitido | Windows Vista [solo aplicaciones de escritorio] |
servidor mínimo admitido | Windows Server 2008 [solo aplicaciones de escritorio] |
de la plataforma de destino de |
Windows |
encabezado de |
winbase.h (incluya Windows.h) |
biblioteca de |
Kernel32.lib |
DLL de |
Kernel32.dll |