Exemples de l’API Bindlink
Ces exemples pour l’API de lien d’association montrent comment l’utiliser pour créer et supprimer des liens d’association.
Exemples CreateBindLink et RemoveBindLink
Cet exemple montre comment utiliser les API de lien d’association pour lier un virtualPath local à un backingPath local ou distant. Il montre également comment supprimer le lien d’association créé.
Remarque
La création et la suppression de liens d’association nécessitent des privilèges Administrateur.
L’exemple de lien d’association prend en charge les opérations suivantes :
- Création d’un lien d’association entre virtualPath et backingPath, éventuellement en mode lecture seule et/ou fusion
- Suppression du lien d’association
#include <wil\resource.h>
#include <string>
#include <iostream>
#include <iomanip>
#if !__has_include(<bindlink.h>)
#error This sample requires the Windows SDK version 10.0.25314.0 or higher.
#endif
#include <bindlink.h>
void usage(FILE* fp)
{
fprintf(fp, "Usage: BindLink command command-parameters [command-options]\n");
fprintf(fp, "Commands:\n");
fprintf(fp, " CREATE virtPath targetPath\n");
fprintf(fp, " REMOVE virtPath\n");
fprintf(fp, "Command options for CREATE:\n");
fprintf(fp, " /merge merge bind links\n");
fprintf(fp, " /read-only read only bind links\n");
}
void printErrorDetails(PCWSTR command, HRESULT hr)
{
std::wcout << command << " failed with HRESULT 0x" << std::hex << std::setw(8) << std::setfill(L'0') << hr << "\n";
wchar_t buffer[32768];
if (FormatMessageW(FORMAT_MESSAGE_FROM_SYSTEM | FORMAT_MESSAGE_IGNORE_INSERTS, nullptr, hr,
0, buffer, ARRAYSIZE(buffer), nullptr))
{
std::wcout << buffer << "\n";
}
}
int handleCreateCommand(int argc, wchar_t* argv[])
{
// argv[0] = program name
// argv[1] = "CREATE"
// argv[2] = virtPath
// argv[3] = backingPath
// argv[4...] = options
if (argc < 4)
{
usage(stderr);
return 1;
}
PCWSTR virtPath = argv[2];
PCWSTR backingPath = argv[3];
auto bindLinkFlags = CREATE_BIND_LINK_FLAG_NONE;
for (int index = 4; index < argc && argv[index][0] == L'/'; ++index)
{
if (!_wcsicmp(argv[index], L"/read-only"))
{
WI_SetFlag(bindLinkFlags, CREATE_BIND_LINK_FLAG_READ_ONLY);
}
else if (!_wcsicmp(argv[index], L"/merge"))
{
WI_SetFlag(bindLinkFlags, CREATE_BIND_LINK_FLAG_MERGED);
}
else
{
usage(stderr);
return 1;
}
}
auto hr = CreateBindLink(virtPath, backingPath, bindLinkFlags, 0, nullptr);
if (FAILED(hr))
{
printErrorDetails(L"CreateBindLink", hr);
return hr;
}
std::wcout << "Bind Link Created.\n";
std::wcout << "\"" << virtPath << "\" draws content from \"" << backingPath << "\"\n";
return 0;
}
int handleRemoveCommand(int argc, wchar_t* argv[])
{
// argv[0] = program name
// argv[1] = "REMOVE"
// argv[2] = virtPath
if (argc != 3)
{
usage(stderr);
return 1;
}
PCWSTR virtPath = argv[2];
auto hr = RemoveBindLink(virtPath);
if (FAILED(hr))
{
printErrorDetails(L"RemoveBindLink", hr);
return hr;
}
std::wcout << "Bind Link for \"" << virtPath << "\" removed.\n";
return 0;
}
int wmain(int argc, wchar_t* argv[])
{
if (argc < 2) {
usage(stderr);
return 1;
}
if (!_wcsicmp(argv[1], L"CREATE"))
{
return handleCreateCommand(argc, argv);
}
else if (!_wcsicmp(argv[1], L"REMOVE"))
{
return handleRemoveCommand(argc, argv);
}
else
{
usage(stderr);
return 1;
}
return 0;
}