GetSpoolFileHandle 函式

  • 發行項

GetSpoolFileHandle函式會擷取與應用程式目前提交之作業相關聯的多工緩衝處理檔控制碼。

語法

HANDLE GetSpoolFileHandle(
  _In_ HANDLE hPrinter
);

參數

hPrinter [in]

提交作業之印表機的控制碼。 這應該是用來提交作業的相同控制碼。 (使用 OpenPrinter 或 AddPrinter 函式擷取印表機控制碼。)

傳回值

如果函式成功，它會傳回多工緩衝處理檔案的控制碼。

如果函式失敗，它會傳回 INVALID_HANDLE_VALUE。

備註

使用多工緩衝處理檔案的控制碼，您的應用程式可以寫入至多工緩衝處理檔案，並呼叫 WriteFile ，後面接著 CommitSpoolData。

您的應用程式在hPrinter 上呼叫 ClosePrinter，直到上次存取多工緩衝處理檔案之後。 然後它應該呼叫 CloseSpoolFileHandle ，後面接著 ClosePrinter。 即使檔案控制碼本身尚未關閉，嘗試在原始 hPrinter 關閉之後存取多工緩衝處理常式仍會失敗。 如果先呼叫ClosePrinter，CloseSpoolFileHandle本身將會失敗。

如果在列印工作完成多工緩衝處理之前呼叫此函式，此函式將會失敗。

規格需求

需求 值
最低支援的用戶端
 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 2008 [僅限傳統型應用程式]
標頭
Winspool.h (包含 Windows.h)
程式庫
Winspool.lib
DLL
WinSpool.drv
Unicode 與 ANSI 名稱
 GetSpoolFileHandleW (Unicode) 和 GetSpoolFileHandleA (ANSI)

另請參閱

列印

列印多工緩衝處理器 API 函式

OpenPrinter

AddPrinter

ClosePrinter

CloseSpoolFileHandle

CommitSpoolData