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來取得裝置內容的句柄。
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 普遍 |
| 標頭 | winppi.h （包括 Winppi.h） |
| 連結庫 | Gdi32.Lib |
| DLL | Gdi32.dll |