Exemplos da API Bindlink
Esses exemplos para a API de link de ligação demonstram como ela pode ser aproveitada para criar e remover links de ligação.
Exemplo de CreateBindLink e RemoveBindLink
Este exemplo mostra como usar as APIs de link de ligação para vincular um local virtualPath ao backingPath local ou remoto. Ele também demonstra como o link de vínculo criado pode ser excluído.
Observação
Criar e remover links de vínculo requer privilégio de administrador.
O exemplo de link de vínculo oferece suporte às seguintes operações:
- Criando um link de vínculo entre o virtualPath e o backingPath, opcionalmente nos modos somente leitura e/ou mesclagem
- Excluindo o link de vínculo
#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;
}