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結構的指標。

如果函式成功，則傳回值是非零值。

如果此函式失敗，則傳回值為零。

注意

這是封鎖或同步函式，可能不會立即傳回。此函式傳回的速度取決於執行時間因素，例如網路狀態、列印伺服器組態，以及難以在撰寫應用程式時預測的印表機驅動程式實作因素。從管理與使用者介面互動的執行緒呼叫此函式，可能會讓應用程式看起來沒有回應。

您可以針對現有的FORM_INFO_2多次呼叫SetForm，每個呼叫都會新增pDisplayName和wLangId值的其他配對。表單的所有語言版本都會在最近呼叫SetForm時取得FORM_INFO_2的大小和ImageableArea值。

如果呼叫端是遠端且Level為 2，則無法STRING_MUIDLL FORM_INFO_2的StringType值。

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	Winspool.h (包含 Windows.h)
程式庫	Winspool.lib
DLL	Winspool.drv
Unicode 與 ANSI 名稱	SetFormW (Unicode) 和 SetFormA (ANSI)