Compartilhar via

Função PrjStartVirtualizing (projectedfslib.h)

  • Artigo

Configura uma instância de virtualização do ProjFS e a inicia, disponibilizando-a para e/S de serviço e invocando retornos de chamada no provedor.

Sintaxe

HRESULT PrjStartVirtualizing(
  [in]           PCWSTR                               virtualizationRootPath,
  [in]           const PRJ_CALLBACKS                  *callbacks,
  [in, optional] const void                           *instanceContext,
  [in, optional] const PRJ_STARTVIRTUALIZING_OPTIONS  *options,
  [out]          PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT *namespaceVirtualizationContext
);

Parâmetros

[in] virtualizationRootPath

Ponteiro para uma cadeia de caracteres unicode terminada em nulo especificando o caminho completo para o diretório raiz de virtualização.

O provedor deve ter chamado PrjMarkDirectoryAsPlaceholder passando o caminho especificado como o parâmetro rootPathName e NULL como o parâmetro targetPathName antes de chamar essa rotina. Isso só precisa ser feito uma vez para designar o caminho como o diretório raiz de virtualização

[in] callbacks

Ponteiro para uma estrutura PRJ_CALLBACKS que foi preenchida com ponteiros para as funções de retorno de chamada do provedor.

[in, optional] instanceContext

Ponteiro para informações de contexto definidas pelo provedor para cada instância. Esse parâmetro é opcional e pode ser NULL. Se for especificado, o ProjFS o retornará no membro InstanceContext do PRJ_CALLBACK_DATA ao invocar rotinas de retorno de chamada do provedor.

[in, optional] options

Um ponteiro opcional para um PRJ_STARTVIRTUALIZING_OPTIONS.

[out] namespaceVirtualizationContext

Em caso de êxito, retorna um identificador opaco para a instância de virtualização do ProjFS. O provedor passa esse valor ao chamar funções que exigem um PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT como entrada.

Retornar valor

O erro HRESULT_FROM_WIN32(ERROR_REPARSE_TAG_MISMATCH), indica que virtualizationRootPath não foi configurado como uma raiz de virtualização.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1809 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho projectedfslib.h