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 不同。

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