Edit

Share via


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

Definition

Finds occurrences of a type description in a type library.

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)

Parameters

szNameBuf
String

The name to search for. This is an in/out parameter.

lHashVal
Int32

A hash value to speed up the search, computed by the LHashValOfNameSys function. If lHashVal is 0, a value is computed.

ppTInfo
ITypeInfo[]

When this method returns, contains an array of pointers to the type descriptions that contain the name specified in szNameBuf. This parameter is passed uninitialized.

rgMemId
Int32[]

An array of the MEMBERID 's of the found items; rgMemId [i] is the MEMBERID that indexes into the type description specified by ppTInfo [i]. Cannot be null.

pcFound
Int16

On entry, indicates how many instances to look for. For example, pcFound = 1 can be called to find the first occurrence. The search stops when one instance is found.

On exit, indicates the number of instances that were found. If the in and out values of pcFound are identical, there might be more type descriptions that contain the name.

Remarks

There must be enough room in the rgMemId parameter to hold pcFound entries.

If the type library contains the name specified by the szNameBuf parameter, szNameBuf is overwritten with the name found in the type library, using the casing found in the type library. For example, if type library contains the name "aBc" and the FindName method passes "abc" as the szNameBuf parameter, szNameBuf becomes "aBc" when the method returns.

For more information, see ITypeLib::FindName method.

Applies to