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.