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.