Función CreateBindLink (bindlink.h)

Esta API permite a los administradores crear un vínculo de enlace entre una ruta de acceso virtual y una ruta de acceso de respaldo. La ruta de acceso virtual siempre es local, mientras que la ruta de acceso de respaldo podría ser local o remota (por ejemplo, un recurso compartido de red). El elemento primario de virtualPath debe estar visible para que la creación del vínculo se realice correctamente. Tanto la ruta de acceso virtual como la ruta de acceso de respaldo pueden representar archivos o directorios. El valor de backingPath de un vínculo anterior también puede ser virtualPath para un vínculo posterior. Un usuario con privilegios de administrador solo puede llamar a CreateBindLink. Una vez creado, existe un vínculo de enlace en todo el sistema y dura hasta que se elimina mediante una llamada a RemoveBindLink o hasta que se cierra el sistema.

Sintaxis

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

Parámetros

virtualPath

Ruta de acceso virtual que se va a usar para crear el vínculo de enlace.

backingPath

Ruta de acceso de respaldo que se va a usar para crear el vínculo de enlace.

createBindLinkFlags

Estas marcas pueden cambiar el comportamiento del vínculo de enlace predeterminado para satisfacer las necesidades del usuario. Consulte CREATE_BIND_LINK_FLAGS para obtener más detalles.

exceptionCount

Número de excepciones proporcionadas en el parámetro exceptionPaths .

exceptionPaths

Rutas de acceso de excepción que se excluirán del vínculo de enlace. Tenga en cuenta que las excepciones no se aplican a los vínculos sin anclaje, ya que las rutas de acceso virtuales sin anclaje no tienen descendientes por definición y, por lo tanto, no tienen rutas de acceso aptas. La API devolverá un error si hay un intento de pasar excepciones al vínculo sin anclaje.

Comentarios

Para obtener más información sobre cómo crear vínculos de enlace, vea Información general sobre enlace: creación de vínculos de enlace.

Ejemplos

Para obtener un ejemplo completo de cómo usar las API CreateBindLink y RemoveBindLink , consulte la página de ejemplo de vínculo de enlace .

Requisitos

Requisito Valor
Header bindlink.h
Library bindlink.lib
Archivo DLL bindlink.dll

Consulte también

RemoveBindLink