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


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Finds occurrences of a type description in a type library.

Namespace:   System.Runtime.InteropServices.ComTypes
Assembly:  mscorlib (in mscorlib.dll)

void FindName(
	string szNameBuf,
	int lHashVal,
	ITypeInfo[] ppTInfo,
	int[] rgMemId,
	ref short pcFound


Type: System.String

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

Type: System.Int32

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

Type: System.Runtime.InteropServices.ComTypes.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.

Type: System.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.

Type: System.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.

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 additional information about ITypeLib::FindName, see the MSDN Library.

Universal Windows Platform
Available since 8
.NET Framework
Available since 2.0
Portable Class Library
Supported in: portable .NET platforms
Windows Phone
Available since 8.1
Return to top