PRJ_CALLBACK_DATA-Struktur (projectedfslib.h)

Definiert die Standardinformationen, die für jeden Vorgangsrückruf an einen Anbieter übergeben werden.

Syntax

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;

Member

Size

Größe in Bytes dieser Struktur. Der Anbieter darf nicht versuchen, auf ein Feld dieser Struktur zuzugreifen, das sich außerhalb dieses Werts befindet.

Flags

Rückrufspezifische Flags.

NamespaceVirtualizationContext

Undurchsichtiges Handle für die Virtualisierung instance, die den Rückruf sendet.

CommandId

Ein Wert, der einen bestimmten Aufruf eines Rückrufs eindeutig identifiziert. Der Anbieter verwendet diesen Wert:

• In Aufrufen von PrjCompleteCommand , um die Vervollständigung eines Rückrufs zu signalisieren, von dem zuvor HRESULT_FROM_WIN32(ERROR_IO_PENDING) zurückgegeben wurde.
• Wenn ProjFS einen PRJ_CANCEL_COMMAND_CB Rückruf sendet. Die commandId im PRJ_CANCEL_COMMAND_CB-Aufruf identifiziert einen früheren Aufruf eines Rückrufs, den der Anbieter abbrechen soll.

FileId

Ein Wert, der das Dateihandle für den Rückruf eindeutig identifiziert.

DataStreamId

Ein Wert, der einen offenen Datenstrom für den Rückruf eindeutig identifiziert.

FilePathName

Der Pfad zur Zieldatei. Dies ist eine NULL-Zeichenfolge von Unicode-Zeichen. Dieser Pfad wird immer relativ zum Virtualisierungsstamm angegeben.

VersionInfo

Versionsinformationen, wenn das Ziel des Rückrufs ein Platzhalter oder eine Teildatei ist.

TriggeringProcessId

Der Prozessbezeichner für den Prozess, der diesen Rückruf ausgelöst hat. Wenn diese Informationen nicht verfügbar sind, ist dies 0. Rückrufe, die diese Informationen bereitstellen, umfassen : PRJ_GET_PLACEHOLDER_INFO_CB, PRJ_GET_FILE_DATA_CB und PRJ_NOTIFICATION_CB.

TriggeringProcessImageFileName

Eine Unicode-Zeichenfolge mit Null-Endung, die den Namen der Imagedatei angibt, die TriggeringProcessId entspricht. Wenn TriggeringProcessId 0 ist, ist dies NULL.

InstanceContext

Ein Zeiger auf kontextbezogene Informationen, die vom Anbieter definiert werden. Der Anbieter übergibt diesen Kontext im parameter instanceContext von PrjStartVirtualizing.

Wenn der Anbieter keinen solchen Kontext angegeben hat, ist dieser Wert NULL.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1809 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server [nur Desktop-Apps]
Kopfzeile	projectedfslib.h