SetForm 函式
SetForm 函式會設定指定印表機的表單資訊。
語法
BOOL SetForm(
_In_ HANDLE hPrinter,
_In_ LPTSTR pFormName,
_In_ DWORD Level,
_In_ LPTSTR pForm
);
參數
-
hPrinter [in]
-
設定表單資訊之印表機的控制碼。 使用 OpenPrinter 或 AddPrinter 函式來擷取印表機控制碼。
-
pFormName [in]
-
以 Null 結束之字串的指標，指定設定表單資訊的表單名稱。
-
層級 [in]
-
pForm指向的結構版本。 此值必須是 1 或 2。
-
pForm [in]
-
FORM_INFO_1或FORM_INFO_2結構的指標。
傳回值
如果函式成功，則傳回值是非零值。
如果此函式失敗，則傳回值為零。
備註
注意
這是封鎖或同步函式，可能不會立即傳回。 此函式傳回的速度取決於執行時間因素，例如網路狀態、列印伺服器設定，以及撰寫應用程式時難以預測的印表機驅動程式實作因素。 從管理與使用者介面互動的執行緒呼叫此函式，可能會使應用程式看起來沒有回應。
SetForm 可以針對現有的 FORM_INFO_2多次呼叫，每個呼叫都會新增額外的 pDisplayName 和 wLangId 值組。 表單的所有語言版本都會在最近呼叫SetForm時取得FORM_INFO_2的大小和ImageableArea值。
如果呼叫端是遠端且Level為 2，則無法STRING_MUIDLL FORM_INFO_2的StringType值。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows 2000 Server [僅限桌面應用程式] |
| 標頭 |
|
| 程式庫 |
|
| DLL |
|
| Unicode 與 ANSI 名稱 |
SetFormW (Unicode) 和 SetFormA (ANSI) |