SetupSetFileQueueFlags 函式 (setupapi.h)

[此函式可用於需求一節中所述的操作系統。它在後續版本中可能會變更或無法使用。安裝程式API不應再用於安裝應用程式。請改用 Windows Installer 來開發應用程式安裝程式。 SetupAPI 會繼續用於安裝設備驅動器。]

SetupSetFileQueueFlags 函式會在安裝程式檔案佇列上設定旗標。

語法

WINSETUPAPI BOOL SetupSetFileQueueFlags(
  [in] HSPFILEQ FileQueue,
  [in] DWORD    FlagMask,
  [in] DWORD    Flags
);

[in] FileQueue

處理開啟的安裝程式檔案佇列。

[in] FlagMask

有效旗標的遮罩。

旗標	意義
SPQ_FLAG_VALID 0x001	用於SPQ_FLAG_BACKUP_AWARE的遮罩。

[in] Flags

搭配 SetupSetFileQueueFlags 使用的旗標， 並由 SetupGetFileQueueFlags 傳回。

旗標	意義
SPQ_FLAG_BACKUP_AWARE 0x001	如果設定此旗標， SetupCommitFileQueue 會發出備份通知。
SPQ_FLAG_ABORT_IF_UNSIGNED 0X002	僅供內部使用。

如果函式成功，則傳回值是非零值。

如果函式失敗，傳回值會 (0) 零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。