wiasGetContextFromName 函式 (wiamdef.h)

wiasGetContextFromName 函式會擷取專案名稱的項目內容。

語法

HRESULT wiasGetContextFromName(
  [in]  BYTE *pWiasContext,
        LONG lFlags,
  [in]  BSTR bstrName,
  [out] BYTE **ppWiasContext
);

[in] pWiasContext

WIA 專案內容的指標。

lFlags

保留供系統使用，且應設定為 0。

[in] bstrName

指定正在搜尋的內容名稱。

[out] ppWiasContext

接收 WIA 專案內容位址的記憶體位置指標。

成功時，函式會傳回S_OK。

如果函式失敗，它會傳回標準 COM 錯誤或其中一個 WIA 錯誤碼。

此函式會搜尋WIA_IPA_FULL_ITEM_NAME屬性符合 bstrName 的項目內容。請注意，此屬性與WIA_IPA_ITEM_NAME不同，但不包含路徑資訊。

當minidrivers需要從某個應用程式項目內容移至另一個應用程式項目內容時，應該使用此函式，因為項目的名稱。應用程式專案的名稱來自其對應的驅動程序專案，迷你驅動程式會建立和名稱。