Función CreateHardLinkTransactedA (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 mediante técnicas más sencillas y disponibles. Además, es posible que TxF no esté disponible en versiones futuras de Microsoft Windows. Para más información y alternativas a TxF, consulte Alternativas al uso de NTFS transaccional].
Establece un vínculo físico entre un archivo existente y un nuevo archivo como una operación de transacción. Esta función solo se admite en el sistema de archivos NTFS y solo para archivos, no directorios.
Sintaxis
BOOL CreateHardLinkTransactedA(
[in] LPCSTR lpFileName,
[in] LPCSTR lpExistingFileName,
LPSECURITY_ATTRIBUTES lpSecurityAttributes,
[in] HANDLE hTransaction
);
Parámetros
[in] lpFileName
Nombre del nuevo archivo.
Este parámetro no puede especificar el nombre de un directorio.
[in] lpExistingFileName
Nombre del archivo existente.
Este parámetro no puede especificar el nombre de un directorio.
lpSecurityAttributes
Reservados; debe ser NULL.
[in] hTransaction
Identificador de la transacción. La función CreateTransaction devuelve este identificador.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero (0). Para obtener información de error extendida, llame a GetLastError.
El número máximo de vínculos físicos que se pueden crear con esta función es de 1023 por archivo. Si se crean más de 1023 vínculos para un archivo, se produce un error.
Los archivos deben residir en el equipo local; de lo contrario, se produce un error en la función y el último código de error se establece en ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE.
Comentarios
Cualquier entrada de directorio para un archivo creado con CreateFileTransacted o CreateHardLinkTransacted es un vínculo físico a un archivo asociado. Un vínculo físico adicional que se crea con la función CreateHardLinkTransacted le permite tener varias entradas de directorio para un archivo, es decir, varios vínculos físicos al mismo archivo, que pueden ser nombres diferentes en el mismo directorio, o los mismos o diferentes nombres en directorios diferentes. Sin embargo, todos los vínculos físicos a un archivo deben estar en el mismo volumen.
Dado que los vínculos físicos son solo entradas de directorio para un archivo, cuando una aplicación modifica un archivo a través de cualquier vínculo físico, todas las aplicaciones que usan cualquier otro vínculo físico al archivo ven los cambios. Además, todas las entradas del directorio se actualizan si cambia el archivo. Por ejemplo, si cambia un tamaño de archivo, todos los vínculos físicos al archivo muestran el nuevo tamaño de archivo.
El descriptor de seguridad pertenece al archivo al que apunta un vínculo físico. El propio vínculo es solo una entrada de directorio y no tiene un descriptor de seguridad. Por lo tanto, al cambiar el descriptor de seguridad de un vínculo físico, se cambia el descriptor de seguridad del archivo subyacente y todos los vínculos físicos que apuntan al archivo permiten el acceso recién especificado. No se pueden proporcionar descriptores de seguridad diferentes a un archivo por vínculo físico.
Esta función no modifica el descriptor de seguridad del archivo al que se va a vincular, incluso si se pasa información del descriptor de seguridad en el parámetro lpSecurityAttributes .
Use DeleteFileTransacted para eliminar vínculos físicos. Puede eliminarlos en cualquier orden, independientemente del orden en que se creen.
Las marcas, los atributos, el acceso y el uso compartido especificados en CreateFileTransacted funcionan por archivo. Es decir, si abre un archivo que no permite el uso compartido, otra aplicación no puede compartir el archivo mediante la creación de un nuevo vínculo físico al archivo.
Cuando se crea un vínculo físico en el sistema de archivos NTFS, la información del atributo de archivo de la entrada de directorio solo se actualiza cuando se abre el archivo o cuando se llama a GetFileInformationByHandle con el identificador de un archivo específico.
Vínculos simbólicos: Si la ruta de acceso apunta a un vínculo simbólico, la función crea un vínculo físico al destino.
En Windows 8 y Windows Server 2012, esta función es compatible con las tecnologías siguientes.
| Tecnología | Compatible |
|---|---|
| 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 a errores (ReFS) | No |
Tenga en cuenta que SMB 3.0 no admite TxF.
Nota
El encabezado winbase.h define CreateHardLinkTransacted 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 Convenciones para prototipos de función.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | winbase.h (incluye Windows.h) |
| Library | Kernel32.lib |
| Archivo DLL | Kernel32.dll |