Fonction PrjStartVirtualizing (projectedfslib.h)

Configure une instance de virtualisation ProjFS et la démarre, la rendant disponible pour les E/S de service et appelle les 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é en tant que paramètre rootPathName et NULL comme paramètre targetPathName avant d’appeler cette routine. Cette opération doit être effectuée une seule fois pour désigner le chemin d’accès en tant que répertoire racine de virtualisation

[in] callbacks

Pointeur vers une structure 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 de routines de rappel de fournisseur.

[in, optional] options

Pointeur facultatif vers un PRJ_STARTVIRTUALIZING_OPTIONS.

[out] namespaceVirtualizationContext

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

Valeur retournée

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

Spécifications