Funzione PrjFillDirEntryBuffer (projectedfslib.h)

Articolo
03/13/2024

Fornisce informazioni per un file o una directory a un'enumerazione.

Sintassi

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

Parametri

[in] fileName

Puntatore a una stringa con terminazione Null contenente il nome della voce

[in, optional] fileBasicInfo

Informazioni di base sulla voce da compilare.

[in] dirEntryBufferHandle

Handle opaco per una struttura che riceve informazioni sulle voci compilate.

Valore restituito

HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) indica che dirEntryBufferHandle non dispone di spazio sufficiente per la nuova voce.

Commenti

Il provider usa questa routine per gestire un callback PRJ_GET_DIRECTORY_ENUMERATION_CB . Quando si elabora il callback, il provider chiama questa routine per ogni file o directory corrispondente nell'enumerazione .

Se questa routine restituisce HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) quando si aggiunge una voce all'enumerazione, il provider restituisce S_OK dal callback e attende il callback PRJ_GET_DIRECTORY_ENUMERATION_CB successivo.

Il provider riprende a riempire l'enumerazione con la voce che stava tentando di aggiungere quando ha ottenuto HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER).

Se questa routine restituisce HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) per la prima voce aggiunta durante qualsiasi chiamata di un callback PRJ_GET_DIRECTORY_ENUMERATION_CB , il provider deve restituire HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) dal callback.

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

Condividi tramite