共用方式為


FCICreate 函式 (fci.h)

FCICreate函式會建立 FCI 內容。

語法

HFCI DIAMONDAPI FCICreate(
  [in, out]      PERF              perf,
  [in]           PFNFCIFILEPLACED  pfnfcifp,
  [in]           PFNFCIALLOC       pfna,
  [in]           PFNFCIFREE        pfnf,
  [in]           PFNFCIOPEN        pfnopen,
  [in]           PFNFCIREAD        pfnread,
  [in]           PFNFCIWRITE       pfnwrite,
  [in]           PFNFCICLOSE       pfnclose,
  [in]           PFNFCISEEK        pfnseek,
  [in]           PFNFCIDELETE      pfndelete,
  [in]           PFNFCIGETTEMPFILE pfnfcigtf,
  [in]           PCCAB             pccab,
  [in, optional] void              *pv
);

參數

[in, out] perf

接收錯誤資訊的 ERF 結構的指標。

[in] pfnfcifp

應用程式定義回呼函式的指標,以在檔案放在封包中時通知。 函式應該使用 FNFCIFILEPLACED 宏來宣告。

[in] pfna

應用程式定義回呼函式的指標,以配置記憶體。 函式應該使用 FNFCIALLOC 宏來宣告。

[in] pfnf

應用程式定義回呼函式的指標,以釋放先前配置的記憶體。 函式應該使用 FNFCIFREE 宏來宣告。

[in] pfnopen

應用程式定義回呼函式的指標,以開啟檔案。 函式應該使用 FNFCIOPEN 宏來宣告。

[in] pfnread

應用程式定義回呼函式的指標,以從檔案讀取資料。 函式應該使用 FNFCIREAD 宏來宣告。

[in] pfnwrite

應用程式定義回呼函式的指標,以將資料寫入檔案。 函式應該使用 FNFCIWRITE 宏來宣告。

[in] pfnclose

應用程式定義回呼函式的指標,以關閉檔案。 函式應該使用 FNFCICLOSE 宏來宣告。

[in] pfnseek

應用程式定義回呼函式的指標,將檔案指標移至特定位置。 函式應該使用 FNFCISEEK 宏來宣告。

[in] pfndelete

要刪除檔案的應用程式定義回呼函式指標。 函式應該使用 FNFCIDELETE 宏來宣告。

[in] pfnfcigtf

應用程式定義回呼函式的指標,以擷取暫存檔案名。 函式應該使用 FNFCIGETTEMPFILE 宏來宣告。

[in] pccab

CCAB結構的指標,其中包含用來建立封包的參數。

[in, optional] pv

傳遞至回呼函式的應用程式定義值指標。

傳回值

如果函式成功,它會傳回非Null HFCI 內容指標;否則為 Null

擴充錯誤資訊是在 ERF 結構中提供。

備註

FCI 支援多個同時的內容。 因此,可以在相同的應用程式中同時建立或擷取多個封包。 如果應用程式是多執行緒的,您也可以在每個執行緒中執行不同的內容;不過,應用程式無法在多個執行緒中同時使用相同的內容。 例如,使用相同的 FCI 內容,無法從兩個不同的執行緒呼叫 FCIAddFile

需求

   
目標平台 Windows
標頭 fci.h
程式庫 Cabinet.lib
Dll Cabinet.dll

另請參閱

FCIAddFile

FCIDestroy

FCIFlushFolder