EngGetForm 函式 (winddi.h)
EngGetForm 函式會取得指定表單FORM_INFO_1詳細數據。
語法
ENGAPI BOOL EngGetForm(
[in] HANDLE hPrinter,
[in] LPWSTR pFormName,
[in] DWORD Level,
[in, optional] LPBYTE pForm,
[in] DWORD cbBuf,
[out] LPDWORD pcbNeeded
);
參數
[in] hPrinter
要指定表單之印表機的句柄。
[in] pFormName
指定表單名稱之字串的指標。
[in] Level
指定 pForm 指向的表單結構版本。 這個值必須是 1，表示窗體資訊將在FORM_INFO_1結構中傳回。
[in, optional] pForm
接收初始化FORM_INFO_1結構的位元組數位指標。
[in] cbBuf
指定 pForm 的大小，以位元組為單位。
[out] pcbNeeded
值的指標，指定函式成功時，複製到 pForm 所指向之緩衝區的位元組數目。 如果 cbBuf 太小，則此值是執行複製所需的位元元組數目。
傳回值
如果窗體結構成功複製到 pForm，EngGetForm 會傳回 TRUE。 否則，它會記錄錯誤訊息並傳回 FALSE。 若要取得錯誤資訊，請呼叫 EngGetLastError。
備註
EngGetForm 會傳回FORM_INFO_1結構 (Microsoft Windows SDK 檔中所述，) 包含與 pFormName 相關聯的表單數據。 寫入的數據及其大小會分別透過 pForm 和 其大小分別傳回給呼叫端。 如果 pForm 所指向的陣列不夠大，無法儲存表單數據，則會改為以 azureNeeded 傳回必要的數位大小。
若要取得所有支援表單的清單，印表機驅動程序應該呼叫 EngEnumForms。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Windows 2000 和更新版本的 Windows 作業系統中使用。 |
| 目標平台 | Universal |
| 標頭 | winddi.h (包括 Winddi.h) |
| 程式庫 | Win32k.lib |
| Dll | Win32k.sys |