PRJ_START_DIRECTORY_ENUMERATION_CB função de retorno de chamada (projectedfslib.h)

  • Artigo

Informa ao provedor que uma enumeração de diretório está sendo iniciada.

Sintaxe

PRJ_START_DIRECTORY_ENUMERATION_CB PrjStartDirectoryEnumerationCb;

HRESULT PrjStartDirectoryEnumerationCb(
  [in] const PRJ_CALLBACK_DATA *callbackData,
  [in] const GUID *enumerationId
)
{...}

Parâmetros

[in] callbackData

Informações sobre a operação. Os seguintes membros callbackData são necessários para implementar esse retorno de chamada:

FilePathName Identifica o diretório a ser enumerado.
Versioninfo Fornece informações de versão para o diretório a ser enumerado.

O provedor só pode acessar esse buffer enquanto o retorno de chamada estiver em execução. Se quiser aguardar a operação e exigir dados desse buffer, ele deverá fazer sua própria cópia dele.

[in] enumerationId

Um identificador para esta sessão de enumeração.

Retornar valor

Código de retorno Descrição
S_OK
 O provedor concluiu a operação com êxito.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
 O diretório a ser enumerado não existe no repositório de backup do provedor.
HRESULT_FROM_WIN32(ERROR_IO_PENDING)
 O provedor deseja concluir a operação posteriormente.
 

Um código de erro HRESULT apropriado se o provedor falhar na operação.

Comentários

O ProjFS solicita uma enumeração de diretório do provedor invocando primeiro esse retorno de chamada, depois um ou mais PRJ_GET_DIRECTORY_ENUMERATION_CB retornos de chamada e, em seguida, o retorno de chamada PRJ_END_DIRECTORY_ENUMERATION_CB. Como várias enumerações podem ocorrer em paralelo no mesmo local, o ProjFS usa o argumento enumerationId para associar as invocações de retorno de chamada a uma única sessão de enumeração, o que significa que um determinado conjunto de chamadas para os retornos de chamada de enumeração usará o mesmo valor para enumerationId para a mesma sessão.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1809 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho projectedfslib.h