Funzione PrjStartVirtualizing (projectedfslib.h)

Configura un'istanza di virtualizzazione ProjFS e la avvia, rendendola disponibile per l'I/O del servizio e richiama i callback nel provider.

Sintassi

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
);

Parametri

[in] virtualizationRootPath

Puntatore a una stringa Unicode con terminazione Null che specifica il percorso completo della directory radice di virtualizzazione.

Il provider deve avere chiamato PrjMarkDirectoryAsPlaceholder passando il percorso specificato come parametro rootPathName e NULL come parametro targetPathName prima di chiamare questa routine. Questa operazione deve essere eseguita una sola volta per designare il percorso come directory radice di virtualizzazione

[in] callbacks

Puntatore a una struttura di PRJ_CALLBACKS compilata con puntatori alle funzioni di callback del provider.

[in, optional] instanceContext

Puntatore alle informazioni di contesto definite dal provider per ogni istanza. Questo parametro è facoltativo e può essere NULL. Se viene specificato, ProjFS lo restituirà nel membro InstanceContext di PRJ_CALLBACK_DATA quando si richiamano routine di callback del provider.

[in, optional] options

Puntatore facoltativo a un PRJ_STARTVIRTUALIZING_OPTIONS.

[out] namespaceVirtualizationContext

In caso di esito positivo, viene restituito un handle opaco all'istanza di virtualizzazione ProjFS. Il provider passa questo valore quando si chiamano funzioni che richiedono un PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT come input.

Valore restituito

L'errore HRESULT_FROM_WIN32(ERROR_REPARSE_TAG_MISMATCH) indica che virtualizationRootPath non è stato configurato come radice di virtualizzazione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10, versione 1809 [solo app desktop]
Server minimo supportato	Windows Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	projectedfslib.h