Fonction PrjStartVirtualizing (projectedfslib.h)

Configure un instance de virtualisation ProjFS et le démarre, le rendant disponible pour le service d’E/S et appelez des rappels sur le fournisseur.

Syntaxe

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

Paramètres

[in] virtualizationRootPath

Pointeur vers une chaîne Unicode terminée par null spécifiant le chemin d’accès complet au répertoire racine de virtualisation.

Le fournisseur doit avoir appelé PrjMarkDirectoryAsPlaceholder en passant le chemin spécifié comme paramètre rootPathName et NULL comme paramètre targetPathName avant d’appeler cette routine. Cela ne doit être effectué qu’une seule fois pour désigner le chemin d’accès comme répertoire racine de virtualisation

[in] callbacks

Pointeur vers une structure de PRJ_CALLBACKS qui a été remplie avec des pointeurs vers les fonctions de rappel du fournisseur.

[in, optional] instanceContext

Pointeur vers les informations de contexte définies par le fournisseur pour chaque instance. Ce paramètre est facultatif et peut être NULL. S’il est spécifié, ProjFS le retourne dans le membre InstanceContext de PRJ_CALLBACK_DATA lors de l’appel des routines de rappel du fournisseur.

[in, optional] options

Pointeur facultatif vers un PRJ_STARTVIRTUALIZING_OPTIONS.

[out] namespaceVirtualizationContext

En cas de réussite, retourne un handle opaque à l’instance de virtualisation ProjFS. Le fournisseur transmet cette valeur lors de l’appel de fonctions qui nécessitent une PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT comme entrée.

Valeur retournée

L’erreur, HRESULT_FROM_WIN32(ERROR_REPARSE_TAG_MISMATCH), indique que virtualizationRootPath n’a pas été configuré en tant que racine de virtualisation.

Configuration requise