Fonction PrjWritePlaceholderInfo (projectedfslib.h)

Envoie des métadonnées de fichier ou de répertoire à ProjFS.

Syntaxe

HRESULT PrjWritePlaceholderInfo(
  [in] PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT namespaceVirtualizationContext,
  [in] PCWSTR                               destinationFileName,
  [in] const PRJ_PLACEHOLDER_INFO           *placeholderInfo,
  [in] UINT32                               placeholderInfoSize
);

Paramètres

[in] namespaceVirtualizationContext

Handle opaque pour le instance de virtualisation. Il doit s’agir de la valeur du membre VirtualizationInstanceHandle du callbackData transmis au fournisseur dans le rappel PRJ_GET_PLACEHOLDER_INFO_CB .

[in] destinationFileName

Chaîne Unicode terminée par null spécifiant le chemin d’accès, relatif à la racine de virtualisation, au fichier ou au répertoire pour lequel créer un espace réservé.

Il doit s’agir d’une correspondance avec le membre FilePathName du paramètre callbackData passé au fournisseur dans le rappel PRJ_GET_PLACEHOLDER_INFO_CB . Le fournisseur doit utiliser la fonction PrjFileNameCompare pour déterminer si les deux noms correspondent.

Par exemple, si le rappel PRJ_GET_PLACEHOLDER_INFO_CB spécifie « dir1\dir1\FILE.TXT » dans callbackData-FilePathName> et que le magasin de stockage du fournisseur contient un fichier appelé « File.txt » dans le répertoire dir1\dir2 et que PrjFileNameCompare retourne 0 lors de la comparaison des noms « FILE.TXT » et « File.txt », le fournisseur spécifie « dir1\dir2\File.txt » comme valeur de ce paramètre.

[in] placeholderInfo

Pointeur vers les métadonnées du fichier ou du répertoire.

[in] placeholderInfoSize

Taille en octets de la mémoire tampon pointée vers par placeholderInfo.

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Le fournisseur utilise cette routine pour fournir les données demandées dans un appel de son rappel PRJ_GET_PLACEHOLDER_INFO_CB , ou il peut l’utiliser pour poser de manière proactive un espace réservé.

Les membres EaInformation, SecurityInformation et StreamsInformation de PRJ_PLACEHOLDER_INFO sont facultatifs. Si le fournisseur ne souhaite pas fournir d’attributs étendus, descripteurs de sécurité personnalisés ou d’autres flux de données, il doit définir ces champs sur 0.

Configuration requise