IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace 方法 (prcomoem.h)
IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace 方法會查詢裝置的預設命名空間統一資源標識符, (URI) 。
語法
HRESULT QueryDeviceDefaultNamespace(
[out] OUT BSTR *pbstrNamespaceUri
);
參數
[out] pbstrNamespaceUri
接收命名空間 URI 之 BSTR 的指標。 外掛程式會將命名空間 URI 放在 pbstrNamespaceUri 指向的緩衝區中。 IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace 負責透過呼叫) Microsoft Windows SDK SysAllocString (中所述的 SysAllocString (來配置字符串,但呼叫端負責釋放字符串。
傳回值
IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace 應該會傳回下列其中一個值。
傳回碼 | 描述 |
---|---|
S_OK | 作業成功。 |
E_NOTIMPL | 外掛程式不打算覆寫核心驅動程式從外掛程式提供者產生的預設命名空間。 |
備註
外掛程式應該指定核心驅動程式應該用來處理 GPD 檔案或核心驅動程式無法辨識之 PPD 檔案中所定義之任何功能的私人命名空間 URI 名稱。 外掛程式可能會指定一組命名空間,做為 呼叫 IPrintOemPrintTicketProvider::BindPrinter 方法的結果。 IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace 的目的是通知核心驅動程式,這些命名空間中的哪一個是做為預設命名空間。 核心驅動程式會將它無法辨識的所有功能與這個預設命名空間產生關聯,並將任何這類功能放在列印票證中。
當 IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace 傳回時,核心驅動程式會負責將外掛程式在 *pbstrNamespaceUri) 中指定的私人命名空間 URI 新增至 DOM 檔的根節點 (。 核心驅動程式也必須定義外掛程式在外掛程式私人命名空間下將新節點新增至列印票證時,外掛程式應該使用的私用命名空間前置詞。 外掛程式不應該為此預設私用命名空間 URI 定義自己的前置詞。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | prcomoem.h (包含 Prcomoem.h) |