ITypeLib.FindName(String, Int32, ITypeInfo[], Int32[], Int16) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Localiza ocorrências de uma descrição de tipo em uma biblioteca de tipos.
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)Parâmetros
- szNameBuf
- String
O nome a ser pesquisado. Esse é um parâmetro de entrada/saída.
- lHashVal
- Int32
Um valor de hash para acelerar a pesquisa, computada pela LHashValOfNameSys função. Se lHashVal for 0, um valor será computado.
- ppTInfo
- ITypeInfo[]
Quando esse método é retornado, contém uma matriz de ponteiros para as descrições de tipo que contêm o nome especificado em szNameBuf. Esse parâmetro é passado sem inicialização.
- rgMemId
- Int32[]
Uma matriz dos MEMBERID itens encontrados; rgMemId [i] é o MEMBERID índice na descrição do tipo especificada por ppTInfo [i]. Não pode ser null.
- pcFound
- Int16
Na entrada, indica quantas instâncias procurar. Por exemplo, pcFound = 1 pode ser chamado para localizar a primeira ocorrência. A pesquisa é interrompida quando uma instância é encontrada.
Na saída, indica o número de instâncias que foram encontradas. Se os valores e out valores in forem pcFound idênticos, poderá haver mais descrições de tipo que contenham o nome.
Comentários
Deve haver espaço suficiente no rgMemId parâmetro para manter pcFound as entradas.
Se a biblioteca de tipos contiver o nome especificado pelo szNameBuf parâmetro, szNameBuf será substituída com o nome encontrado na biblioteca de tipos, usando a caixa encontrada na biblioteca de tipos. Por exemplo, se a biblioteca de tipos contiver o nome "aBc" e o FindName método passar "abc" como o szNameBuf parâmetro, szNameBuf se tornará "aBc" quando o método retornar.
Para obter mais informações, consulte o método ITypeLib::FindName.