EngSetPrinterData 函式 (winddi.h)
EngSetPrinterData函式在 Windows 2000 和更新版本中已過時。
在舊版的 Windows EngSetPrinterData 中，會設定指定印表機的組態資料。
語法
ENGAPI DWORD EngSetPrinterData(
[in] HANDLE hPrinter,
[in] LPWSTR pType,
[in] DWORD dwType,
[in] LPBYTE lpbPrinterData,
[in] DWORD cjPrinterData
);
參數
[in] hPrinter
應設定設定資料的印表機控制碼。 這是傳遞為DrvEnablePDEV之 hDriver參數的控制碼。 請參閱備註。
[in] pType
識別要設定之資料的 Null 終止字串指標。
[in] dwType
這是指定要設定之資訊類型的旗標。 此參數可以是下列其中一個值：
| 值 | 意義 |
|---|---|
| REG_BINARY | 任何形式的二進位資料， |
| REG_DWORD | 32 位數位。 |
| REG_DWORD_BIG_ENDIAN | 以大到尾格式的 32 位數位，這表示單字的最顯著位元組是低序位元組。 |
| REG_DWORD_LITTLE_ENDIAN | 以小到尾格式的 32 位數位 (與REG_DWORD) 相同，這表示單字的最顯著位元組是高序位元組位元組 |
| REG_EXPAND_SZ | null 終止的字串，其中包含環境變數的未展開參考 (，例如 「%PATH%」 ) 。 它會是 Unicode 或 ANSI 字串，視是否使用 Unicode 或 ANSI 函式而定。 |
| REG_LINK | Unicode 符號連結。 |
| REG_MULTI_SZ | 以 null 結尾的字串所組成的陣列，整個陣列最後以兩個 null 字元做為結尾。 |
| REG_NONE | 沒有定義的實值型別。 |
| REG_RESOURCE_LIST | 設備磁碟機資源清單。 |
| REG_SZ | null 終止的字串。 它會是 Unicode 或 ANSI 字串，視您使用 Unicode 或 ANSI 函式而定。 |
[in] lpbPrinterData
要設定之印表機組態資料的指標。 所指向的資料類型是由 dwType所決定。
[in] cjPrinterData
指定 lpbPrinterData的大小，以位元組為單位。
傳回值
EngSetPrinterData 會傳回上次記錄的錯誤訊息。
備註
從 Microsoft Windows 2000 開始，此函式已過時。 用於呼叫 EngSetPrinterData 和 DrvEnablePDEV 函式的控制碼具有不同的存取權限;因此，這些函式不再一起運作。 用於呼叫DrvEnablePDEV函式的hDriver參數會以PRINTER_ACCESS_USE存取權開啟。 相反地，在呼叫EngSetPrinterData函式時所使用的hPrinter參數必須已以PRINTER_ALL_ACCESS存取權開啟。 因此，核心模式印表機驅動程式無法 (唯一可以呼叫 EngSetPrinterData 的印表機驅動程式類型) 使用 EngSetPrinterData 將印表機的相關資訊寫入登錄。
如需印表機存取權限的詳細資訊，請參閱 Windows SDK 檔) 中所述的PRINTER_DEFAULTS結構 (。
規格需求
| 最低支援的用戶端 | 可在 Windows 2000 和更新版本的 Windows 作業系統中使用。 |
| 目標平台 | Universal |
| 標頭 | winddi.h (包括 Winddi.h) |
| 程式庫 | Win32k.lib |
| Dll | Win32k.sys |