共用方式為


IPrintOemUI::GetInfo 方法 (prcomoem.h)

使用者介面外掛程式的 IPrintOemUI::GetInfo 方法會傳回識別資訊。

語法

HRESULT GetInfo(
  DWORD  dwMode,
  PVOID  pBuffer,
  DWORD  cbSize,
  PDWORD pcbNeeded
);

參數

dwMode

包含下列其中一個呼叫端提供的整數常數。

OEMGI_GETREQUESTEDHELPERINTERFACES

如果 IPrintOemUI::P ublishDriverInterface 方法,方法必須將 OEMPUBLISH_IPRINTCOREHELPER 的位旗標值寫入緩衝區 pBuffer 使用參數 pIUnknown 呼叫, 指向實作 IPrintCoreHelperPS 介面IPrintCoreHelperUni 介面的物件。

OEMGI_GETSIGNATURE

方法必須傳回唯一的四位元組識別簽章。 外掛程式也必須將此簽章放在 OPTITEM 結構中,如 OEMCUIPPARAM 結構 pOEMOptItems 成員的描述中所述。

OEMGI_GETVERSION

方法必須將使用者介面外掛程式的版本號碼傳回為 DWORD。 版本格式為開發人員定義。

pBuffer

呼叫端提供的記憶體指標,該指標配置以接收 dwMode 所指定的資訊,

cbSize

pBuffer所指向之緩衝區的呼叫端提供大小。

pcbNeeded

呼叫端提供的位置指標,以接收寫入緩衝區的位元元組數,pBuffer所指向的緩衝區。

傳回值

方法必須傳回下列其中一個值。

傳回碼 描述
S_OK
作業成功。
E_FAIL
作業失敗。
E_NOTIMPL
未實作 方法。

言論

需要使用者介面外掛程式才能實作 IPrintOemUI::GetInfo 方法,這個方法會在載入外掛程式之後立即呼叫。 方法應該將指定的資訊寫入 pBuffer 所指定的位址,並以位元組為單位,將傳回的資訊寫入 所指定的位置。

如果 pBuffer NULL,則方法應該只使用 來傳回儲存指定資訊所需的位元元組數目。

如需建立及安裝使用者介面外掛程式的詳細資訊,請參閱 自定義Microsoft的印表機驅動程式

要求

要求 價值
目標平臺 桌面
標頭 prcomoem.h (include Prcomoem.h)

另請參閱

IPrintOemPS::GetInfo

IPrintOemUI

IPrintOemUni::GetInfo