Função PrjStartVirtualizing (projectedfslib.h)

Configura uma instância de virtualização do ProjFS e a inicia, disponibilizando-a para e/S do 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 de 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

Com o sucesso, retorna uma alça opaca para a instância de virtualização do ProjFS. O provedor passa esse valor ao chamar funções que exigem uma PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT como entrada.

Valor de retorno

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

Requirements