Función RemoveBindLink (bindlink.h)

Esta API permite a un usuario quitar un vínculo creado anteriormente mediante una llamada a CreateBindLink.

Sintaxis

HRESULT RemoveBindLink(
  PCWSTR virtualPath
);

Parámetros

virtualPath

Ruta de acceso virtual para la que se va a quitar el vínculo de enlace.

Comentarios

Esta API producirá un error si el usuario no tiene privilegios de administrador, o si el usuario no tiene permiso para acceder a la ruta de acceso virtual, o si el vínculo que se va a eliminar es el antecesor de un vínculo existente. También se producirá un error en la API si el vínculo no existe o debido a otro error interno. Si una aplicación está en medio de recorrer la ruta de acceso virtual mientras se llama a RemoveBindLink , el comportamiento resultante dependerá de dónde se encuentre cada uno de los subprocesos en el proceso (es decir, se trata de una carrera entre el vínculo al que se va a eliminar y al archivo o directorio al que se accede).

Tenga en cuenta que los vínculos anidados deben quitarse en orden más profundo. Esto significa que se debe quitar la ruta de acceso virtual más profunda antes de que se puedan quitar las rutas de acceso virtuales antecesoras. Se espera que los servicios no relacionados que creen los vínculos y quiten los vínculos sean respetuosos del espacio personal del otro y limiten sus asignaciones a las rutas de acceso bajo su control.

Ejemplos

En el ejemplo siguiente se muestra cómo un usuario puede quitar un vínculo creado anteriormente en C:\\test.

#include <iostream>
#include <wil\resource.h>
#include <bindlink.h>

int wmain(int argc, wchar_t* argv[])
{
    constexpr PCWSTR virtPath = L"C:\test";
    HRESULT hr = S_OK;

    hr = RemoveBindLink(virtPath);

    if(FAILED(hr))
    {
        std::cerr << "CreateBindLink Failed with Err: " << hr;
        return hr;
    }

    std::cout << "Link Deleted!\n";
}

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

Requisitos

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

Consulte también

CreateBindLink