Compartilhar via


estrutura PRJ_CALLBACK_DATA (projectedfslib.h)

Define as informações padrão passadas a um provedor para cada retorno de chamada de operação.

Sintaxe

typedef struct PRJ_CALLBACK_DATA {
  UINT32                               Size;
  PRJ_CALLBACK_DATA_FLAGS              Flags;
  PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT NamespaceVirtualizationContext;
  INT32                                CommandId;
  GUID                                 FileId;
  GUID                                 DataStreamId;
  PCWSTR                               FilePathName;
  PRJ_PLACEHOLDER_VERSION_INFO         *VersionInfo;
  UINT32                               TriggeringProcessId;
  PCWSTR                               TriggeringProcessImageFileName;
  void                                 *InstanceContext;
} PRJ_CALLBACK_DATA;

Membros

Size

Tamanho em bytes dessa estrutura. O provedor não deve tentar acessar nenhum campo dessa estrutura localizado além desse valor.

Flags

Sinalizadores específicos de retorno de chamada.

NamespaceVirtualizationContext

Identificador opaco para a instância de virtualização que está enviando o retorno de chamada.

CommandId

Um valor que identifica exclusivamente uma invocação específica de um retorno de chamada. O provedor usa esse valor:

  • Em chamadas para PrjCompleteCommand para sinalizar a conclusão de um retorno de chamada do qual ele retornou anteriormente HRESULT_FROM_WIN32(ERROR_IO_PENDING).
  • Quando o ProjFS envia um retorno de chamada PRJ_CANCEL_COMMAND_CB . A commandId na chamada PRJ_CANCEL_COMMAND_CB identifica uma invocação anterior de um retorno de chamada que o provedor deve cancelar.

FileId

Um valor que identifica exclusivamente o identificador de arquivo para o retorno de chamada.

DataStreamId

Um valor que identifica exclusivamente um fluxo de dados aberto para o retorno de chamada.

FilePathName

O caminho para o arquivo de destino. Essa é uma cadeia de caracteres Unicode terminada em nulo. Esse caminho sempre é especificado em relação à raiz de virtualização.

VersionInfo

Informações de versão se o destino do retorno de chamada for um espaço reservado ou um arquivo parcial.

TriggeringProcessId

O identificador de processo para o processo que disparou esse retorno de chamada. Se essas informações não estiverem disponíveis, elas serão 0. Os retornos de chamada que fornecem essas informações incluem: PRJ_GET_PLACEHOLDER_INFO_CB, PRJ_GET_FILE_DATA_CB e PRJ_NOTIFICATION_CB.

TriggeringProcessImageFileName

Uma cadeia de caracteres Unicode terminada em nulo especificando o nome do arquivo de imagem correspondente a TriggeringProcessId. Se TriggeringProcessId for 0, isso será NULL.

InstanceContext

Um ponteiro para informações de contexto definidas pelo provedor. O provedor passa esse contexto no parâmetro instanceContext de PrjStartVirtualizing.

Se o provedor não especificar esse contexto, esse valor será NULL.

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]
Cabeçalho projectedfslib.h