ITypeLib2.FindName(String, Int32, ITypeInfo[], Int32[], Int16) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
尋找型別描述在型別程式庫中的符合項目。
public:
void FindName(System::String ^ szNameBuf, int lHashVal, cli::array <System::Runtime::InteropServices::ComTypes::ITypeInfo ^> ^ ppTInfo, cli::array <int> ^ rgMemId, short % pcFound);
public void FindName (string szNameBuf, int lHashVal, System.Runtime.InteropServices.ComTypes.ITypeInfo[] ppTInfo, int[] rgMemId, ref short pcFound);
abstract member FindName : string * int * System.Runtime.InteropServices.ComTypes.ITypeInfo[] * int[] * int16 -> unit
Public Sub FindName (szNameBuf As String, lHashVal As Integer, ppTInfo As ITypeInfo(), rgMemId As Integer(), ByRef pcFound As Short)
參數
- szNameBuf
- String
要搜尋的名稱。
- lHashVal
- Int32
用來加速搜尋的雜湊值 (Hash Value),由 LHashValOfNameSys
函式計算而得。 如果 lHashVal
為 0,表示值已計算出來。
- ppTInfo
- ITypeInfo[]
這個方法傳回時,包含型別描述的指標陣列,其包含 szNameBuf
中指定的名稱。 這個參數會以未初始化的狀態傳遞。
- rgMemId
- Int32[]
這個方法傳回時,會包含所找到項目之 MEMBERID
的陣列;rgMemId
[i] 為 MEMBERID
,其索引至由 ppTInfo
[i] 所指定的型別描述。 這個參數不可以是 null
。 這個參數會以未初始化的狀態傳遞。
- pcFound
- Int16
項目上以傳址 (By Reference) 方式傳遞的值,指出要尋找的執行個體 (Instance) 數目。 例如,若要尋找第一個符合項目可以呼叫 pcFound
= 1。 找到一個執行個體時,搜尋便會停止。
結束時,表示找到的執行個體數目。 如果 pcFound
的 in
和 out
值相同,可能還有更多包含該名稱的型別描述。
實作
備註
參數中 rgMemId
必須有足夠的空間來保存 pcFound
專案。
如需詳細資訊,請參閱 ITypeLib::FindName 方法。