RemoveBindLink, fonction (bindlink.h)

Article
03/09/2024

Cette API permet à un utilisateur de supprimer un lien créé précédemment en appelant CreateBindLink.

Syntaxe

HRESULT RemoveBindLink(
  PCWSTR virtualPath
);

Paramètres

virtualPath

Chemin d’accès virtuel pour lequel le lien de liaison doit être supprimé.

Remarques

Cette API échoue si l’utilisateur ne dispose pas de privilèges d’administrateur, si l’utilisateur n’est pas autorisé à accéder au chemin d’accès virtuel, ou si le lien en cours de suppression est l’ancêtre d’un lien existant. L’API échoue également si le lien n’existe pas ou en raison d’une autre erreur interne. Si une application se trouve au milieu du chemin d’accès virtuel pendant que RemoveBindLink est appelé, le comportement résultant dépend de l’endroit où chacun des threads se trouve dans le processus (c’est-à-dire qu’il s’agit d’une course entre le lien en cours de suppression et le fichier/répertoire accessible).

Notez que les liens imbriqués doivent être supprimés dans l’ordre le plus profond. Cela signifie que le chemin d’accès virtuel le plus profond doit être supprimé pour que les chemins virtuels ancêtres puissent être supprimés. Les services non liés qui créent les liens et suppriment les liens sont censés respecter l’espace personnel des autres personnes et limiter leurs mappages aux chemins sous leur contrôle.

Exemples

L’exemple suivant montre comment un utilisateur peut supprimer un lien créé précédemment sur 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";
}

Pour obtenir un exemple complet de l’utilisation des API CreateBindLink et RemoveBindLink , consultez la page d’exemple de lien de liaison .

Configuration requise

Condition requise	Valeur
En-tête	bindlink.h
Bibliothèque	bindlink.lib
DLL	bindlink.dll

Voir aussi

CreateBindLink

Partager via