ITypeLib.FindName(String, Int32, ITypeInfo[], Int32[], Int16) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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 -> unitPublic 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.
