Поделиться через


ITypeLib.FindName(String, Int32, ITypeInfo[], Int32[], Int16) Метод

Определение

Обнаруживает экземпляры описания типа в библиотеке типов.

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

Хэш-значение для ускорения поиска, вычисленное при помощи функции LHashValOfNameSys. Если значение lHashVal равно 0, то значение рассчитывается.

ppTInfo
ITypeInfo[]

При возвращении данного метода содержит массив указателей на описания типов, которые содержат имя, заданное в szNameBuf. Этот параметр передается неинициализированным.

rgMemId
Int32[]

Массив значений MEMBERID найденных элементов. rgMemId[i] является значением MEMBERID, выполняющим индексацию в описании типа, заданном параметром ppTInfo[i]. Не может иметь значение null.

pcFound
Int16

При входе показывает количество разыскиваемых экземпляров. Например, если pcFound = 1 можно использовать для поиска первого экземпляра. Поиск прекращается после обнаружения первого экземпляра.

При выходе показывает число обнаруженных экземпляров. Если значения in и out параметра pcFound идентичны, возможно найдены не все описания типа, содержащие нужное имя.

Комментарии

В параметре rgMemId должно быть достаточно места для хранения pcFound записей.

Если библиотека типов содержит имя, указанное szNameBuf параметром , szNameBuf перезаписывается именем, найденным в библиотеке типов, с помощью регистра, найденного в библиотеке типов. Например, если библиотека типов содержит имя "aBc", а FindName метод передает "abc" в szNameBuf качестве параметра, szNameBuf при возврате метода становится "aBc".

Дополнительные сведения см. в разделе Метод ITypeLib::FindName.

Применяется к