PRJ_CALLBACK_DATA結構 (projectedfslib.h)

定義針對每個作業回呼傳遞至提供者的標準資訊。

語法

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;

成員

Size

這個結構的大小以位元組為單位。 提供者不得嘗試存取此結構中的任何欄位，且該欄位位於此值之外。

Flags

回呼特定旗標。

NamespaceVirtualizationContext

傳送回呼之虛擬化實例的不透明句柄。

CommandId

值，可唯一識別回呼的特定調用。 提供者會使用此值：

• 在 對 PrjCompleteCommand 的呼叫中，表示其先前傳回HRESULT_FROM_WIN32 (ERROR_IO_PENDING) 回呼的完成。
• 當 ProjFS 傳送 PRJ_CANCEL_COMMAND_CB回 呼時。 PRJ_CANCEL_COMMAND_CB呼叫中的 commandId 會識別提供者應該取消的先前回呼調用。

FileId

值，可唯一識別回呼的檔案句柄。

DataStreamId

值，可唯一識別回呼的開啟數據流。

FilePathName

目標檔案的路徑。 這是以 Null 結尾的 Unicode 字元字串。 這個路徑一律會相對於虛擬化根目錄指定。

VersionInfo

如果回呼的目標是佔位元或部分檔案，版本資訊。

TriggeringProcessId

觸發此回呼之進程的進程標識碼。 如果此資訊無法使用，這將會是 0。 提供這項資訊的回呼包括： PRJ_GET_PLACEHOLDER_INFO_CB、 PRJ_GET_FILE_DATA_CB和 PRJ_NOTIFICATION_CB。

TriggeringProcessImageFileName

以 Null 結尾的 Unicode 字串，指定對應至 TriggeringProcessId 的影像檔名稱。 如果 TriggeringProcessId 為 0，這會是 NULL。

InstanceContext

提供者所定義之內容資訊的指標。 提供者會在 PrjStartVirtualizing 的 instanceContext 參數中傳遞此內容。

如果提供者未指定這類內容，這個值將會是 NULL。

規格需求

需求	值
最低支援的用戶端	Windows 10 版本 1809 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server [僅限傳統型應用程式]
標頭	projectedfslib.h