ITypeLib.FindName(String, Int32, ITypeInfo[], Int32[], Int16) 方法

定義

命名空間:

System.Runtime.InteropServices.ComTypes

組件:

System.Runtime.InteropServices.dll

尋找型別描述在型別程式庫中的符合項目。

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

要搜尋的名稱。 這是個 in/out 參數。

lHashVal

Int32

用來加速搜尋的雜湊值 (Hash Value)，由 LHashValOfNameSys 函式計算而得。 如果 lHashVal 為 0，表示值已計算出來。

ppTInfo

ITypeInfo[]

這個方法傳回時，包含型別描述的指標陣列，其包含 szNameBuf 中指定的名稱。 這個參數會以未初始化的狀態傳遞。

rgMemId

Int32[]

所找到項目之 MEMBERID 的陣列；rgMemId[i] 為 MEMBERID，其索引至由 ppTInfo[i] 所指定的型別描述。 不可以是 null。

pcFound

Int16

進入時，表示要尋找多少個執行個體。 例如，若要尋找第一個符合項目可以呼叫 pcFound = 1。 找到一個執行個體時，搜尋便會停止。

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

備註

參數中 rgMemId 必須有足夠的空間可保存 pcFound 專案。

如果類型庫包含 參數所 szNameBuf 指定的名稱， szNameBuf 則會使用類型連結庫中找到的名稱覆寫，方法是使用類型連結庫中找到的大小寫。 例如，如果類型庫包含名稱 「aBc」，而且 FindName 方法會傳遞 「abc」 做為 szNameBuf 參數，當方法傳回時會 szNameBuf 變成 “aBc”。

如需詳細資訊，請參閱 ITypeLib：：FindName 方法。