Funzione RemoveBindLink (bindlink.h)

Articolo
03/13/2024

Questa API consente a un utente di rimuovere un collegamento creato in precedenza chiamando CreateBindLink.

Sintassi

HRESULT RemoveBindLink(
  PCWSTR virtualPath
);

Parametri

virtualPath

Percorso virtuale per il quale il collegamento di associazione deve essere rimosso.

Commenti

Questa API avrà esito negativo se l'utente non ha privilegi di amministratore o se l'utente non dispone dell'autorizzazione per accedere al percorso virtuale oppure se il collegamento eliminato è il predecessore di un collegamento esistente. L'API avrà esito negativo anche se il collegamento non esiste o a causa di un altro errore interno. Se un'app si trova al centro dell'attraversamento del percorso virtuale mentre RemoveBindLink viene chiamata, il comportamento risultante dipenderà dalla posizione in cui ogni thread si trova nel processo ( ad esempio, si tratta di una corsa tra il collegamento eliminato e il file/directory a cui si accede).

Si noti che i collegamenti annidati devono essere rimossi in ordine più profondo. Ciò significa che il percorso virtuale più profondo deve essere rimosso prima che i percorsi virtuali predecessori possano essere rimossi. I servizi non correlati che creano i collegamenti e rimuovino i collegamenti devono essere rispettosi dello spazio personale dell'altro e limitano i mapping ai percorsi sotto il loro controllo.

Esempio

Nell'esempio seguente viene illustrato come un utente può rimuovere un collegamento creato in precedenza in 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";
}

Per un esempio completo di come usare le API CreateBindLink e RemoveBindLink , vedere la pagina dell'esempio di collegamento di associazione .

Requisiti

Requisito	Valore
Intestazione	bindlink.h
Libreria	bindlink.lib
DLL	bindlink.dll

Vedi anche

CreateBindLink

Condividi tramite