GdiGetSpoolFileHandle 函式 (winppi.h)
GdiGetSpoolFileHandle 函式會傳回列印作業 EMF 檔案的句柄。
語法
HANDLE GdiGetSpoolFileHandle(
LPWSTR pwszPrinterName,
LPDEVMODEW pDevmode,
LPWSTR pwszDocName
);
參數
pwszPrinterName
呼叫端提供的字串指標，代表目標列印機的名稱。 請參閱下列一節。
pDevmode
呼叫端提供的 DEVMODEW 結構指標。 請參閱下列一節。
pwszDocName
呼叫端提供的列印作業檔名稱指標。 請參閱下列一節。
傳回值
如果作業成功，函式會傳回多任務緩衝處理檔句柄。 否則函式會傳回 NULL。
備註
GdiGetSpoolFileHandle 函式是由 gdi32.dll 匯出，用於列印處理器的 PrintDocumentOnPrintProcessor 函式內。
當列印處理器呼叫 GdiGetSpoolFileHandle 時，它應該提供自變數，如下表所示。
| 參數 | 引數 |
|---|---|
| pwszPrinterName | 印表處理器的 OpenPrintProcessor 函式所收到的印表機名稱指標。 |
| pDevmode | PRINTPROCESSOROPENDATA 結構中包含的 DEVMODEW 結構的指標，由列印處理器的 OpenPrintProcessor 函式所接收。 |
| pwszDocName | 列印處理器的 PrintDocumentOnPrintProcessor 函式所接收的文件名稱指標。 |
列印處理器必須先呼叫 GdiGetSpoolFileHandle 函式，才能呼叫任何其他 GDI 列印函式，因為傳回的句柄必須傳遞至其他函式。 函式會呼叫 OpenPrinter 來開啟印表機的連接，以及建立用於繪圖的裝置內容 CreateDC。 列印處理器可以藉由呼叫 GdiGetDC 來取得裝置內容的句柄。
如需詳細資訊，請參閱 在列印處理器中使用 GDI 函數。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 標頭 | winppi.h (包括 Winppi.h) |
| 程式庫 | Gdi32.Lib |
| Dll | Gdi32.dll |