AddForm 函式

AddForm函式會將表單新增至可針對指定印表機選取的可用表單清單。

語法

BOOL AddForm(
  _In_ HANDLE hPrinter,
  _In_ DWORD  Level,
  _In_ LPBYTE pForm
);

hPrinter [in]: 支援使用指定表單列印之印表機的控制碼。使用 OpenPrinter 或 AddPrinter 函式來擷取印表機控制碼。
層級 [in]: pForm指向的結構層級。此值必須是 1 或 2。
pForm [in]: FORM_INFO_1或FORM_INFO_2結構的指標。

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

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

注意

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

應用程式可以呼叫 EnumForms 函式來判斷印表機可用的表單。

如果pForm指向FORM_INFO_2，則如果具有指定名稱的表單已經存在或結構的pKeyword值已經存在，AddForm將會失敗。