共用方式為

ITypeLib：：FindName 方法 (oaidl.h)

  • 發行項

尋找型別描述在型別程式庫中的符合項目。 這可用來快速確認類型連結庫中有名稱。

語法

HRESULT FindName(
  [in, out] LPOLESTR  szNameBuf,
  [in]      ULONG     lHashVal,
  [out]     ITypeInfo **ppTInfo,
  [out]     MEMBERID  *rgMemId,
  [in, out] USHORT    *pcFound
);

參數

[in, out] szNameBuf

要搜尋的名稱。

[in] lHashVal

哈希值，可加速搜尋，由 LHashValOfNameSys 函式計算。 如果 lHashVal = 0，則會計算值。

[out] ppTInfo

類型描述的指標陣列，其中包含 szNameBuf 中指定的名稱。 這個參數不可以是 Null。

[out] rgMemId

找到項目的陣列; rgMemId[i] 是 MEMBERID，索引到 ppTInfo[i] 所指定的類型描述中。 這個參數不可以是 Null。

[in, out] pcFound

進入時，表示要尋找多少個執行個體。 例如，可以呼叫 *pcFound = 1 來尋找第一個出現專案。 搜尋會在找到搜尋時停止。

結束時，表示找到的執行個體數目。 如果 *pcFound 的 in 和 out 值相同，則可能會有更多類型描述包含名稱。

傳回值

這個方法可以傳回下列其中一個值。

傳回碼 Description
S_OK
成功。
E_INVALIDARG
一或多個自變數無效。
E_OUTOFMEMORY
記憶體不足，無法完成作業。

備註

傳遞 *pcFound = n 表示 ppTInfo 和 rgMemId 陣列中有足夠的空間可供 n (ptinfo、 memid) 組使用。 如果 szNameBuf 中的名稱是 ppTInfo[i] 中類型資訊的名稱，則函式會在 rgMemId[i] 中傳回MEMBERID_NIL。

規格需求

需求 值
目標平台 Windows
標頭 oaidl.h

另請參閱

ITypeLib