PrjFillDirEntryBuffer, fonction (projectedfslib.h)

Fournit des informations pour un fichier ou un répertoire à une énumération.

Syntaxe

HRESULT PrjFillDirEntryBuffer(
  [in]           PCWSTR                      fileName,
  [in, optional] PRJ_FILE_BASIC_INFO         *fileBasicInfo,
  [in]           PRJ_DIR_ENTRY_BUFFER_HANDLE dirEntryBufferHandle
);

Paramètres

[in] fileName

Pointeur vers une chaîne terminée par null qui contient le nom de l’entrée

[in, optional] fileBasicInfo

Informations de base sur l’entrée à remplir.

[in] dirEntryBufferHandle

Handle opaque vers une structure qui reçoit des informations sur les entrées remplies.

Valeur retournée

HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) indique que dirEntryBufferHandle n’a pas suffisamment d’espace pour la nouvelle entrée.

Remarques

Le fournisseur utilise cette routine pour traiter un rappel PRJ_GET_DIRECTORY_ENUMERATION_CB . Lors du traitement du rappel, le fournisseur appelle cette routine pour chaque fichier ou répertoire correspondant dans l’énumération.

Si cette routine retourne HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) lors de l’ajout d’une entrée à l’énumération, le fournisseur retourne S_OK à partir du rappel et attend le rappel suivant PRJ_GET_DIRECTORY_ENUMERATION_CB .

Le fournisseur reprend le remplissage de l’énumération avec l’entrée qu’il essayait d’ajouter lorsqu’il a obtenu HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER).

Si cette routine retourne HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) pour la première entrée ajoutée lors d’un appel d’un rappel PRJ_GET_DIRECTORY_ENUMERATION_CB , le fournisseur doit retourner HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) à partir du rappel.

Spécifications