Função PrjFillDirEntryBuffer (projectedfslib.h)

Fornece informações para um arquivo ou diretório para uma enumeração.

Sintaxe

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

Parâmetros

[in] fileName

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome da entrada

[in, optional] fileBasicInfo

Informações básicas sobre a entrada a ser preenchida.

[in] dirEntryBufferHandle

Um identificador opaco para uma estrutura que recebe informações sobre as entradas preenchidas.

Valor de retorno

HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) indica que dirEntryBufferHandle não tem espaço suficiente para a nova entrada.

Observações

O provedor usa essa rotina para atender a um retorno de chamada PRJ_GET_DIRECTORY_ENUMERATION_CB. Ao processar o retorno de chamada, o provedor chama essa rotina para cada arquivo ou diretório correspondente na enumeração.

Se essa rotina retornar HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) ao adicionar uma entrada à enumeração, o provedor retornará S_OK do retorno de chamada e aguardará o próximo PRJ_GET_DIRECTORY_ENUMERATION_CB retorno de chamada.

O provedor retoma o preenchimento da enumeração com a entrada que estava tentando adicionar quando obteve HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER).

Se essa rotina retornar HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) para a primeira entrada adicionada durante qualquer invocação de um retorno de chamada PRJ_GET_DIRECTORY_ENUMERATION_CB , o provedor deverá retornar HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) do retorno de chamada.

Requirements