ITypeLib.FindName(String, Int32, ITypeInfo[], Int32[], Int16) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Encontra ocorrências de uma descrição de tipo numa 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 -> unit
Public 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 procurar. Isto é um parâmetro de entrada/saída.
- lHashVal
- Int32
Um valor de hash para acelerar a pesquisa, calculado pela LHashValOfNameSys função. Se lHashVal for 0, um valor é calculado.
- ppTInfo
- ITypeInfo[]
Quando este método retorna, contém um array de ponteiros para as descrições de tipo que contêm o nome especificado em szNameBuf. Este parâmetro é passado sem inicializar.
- rgMemId
- Int32[]
Um array dos MEMBERID 's dos itens encontrados; rgMemId [i] é o MEMBERID que se indexa à descrição do tipo especificada por ppTInfo [i]. Não pode ser null.
- pcFound
- Int16
Na entrada, indica quantas instâncias deve procurar. Por exemplo, pcFound pode ser chamado = 1 para encontrar a primeira ocorrência. A pesquisa termina quando uma instância é encontrada.
Na saída, indica o número de instâncias encontradas. Se os in valores e out de pcFound forem idênticos, podem existir mais descrições de tipo que contenham o nome.
Observações
Deve haver espaço suficiente no rgMemId parâmetro para guardar pcFound entradas.
Se a biblioteca de tipos contiver o nome especificado pelo szNameBuf parâmetro, szNameBuf é sobrescrita pelo nome encontrado na biblioteca de tipos, usando a carcaça encontrada na biblioteca de tipos. Por exemplo, se a biblioteca de tipos contém o nome "aBc" e o FindName método passa "abc" como szNameBuf parâmetro, szNameBuf torna-se "aBc" quando o método retorna.
Para mais informações, consulte o método ITypeLib::FindName.