ITypeLib.FindName(String, Int32, ITypeInfo[], Int32[], Int16) Método

Definição

Namespace:

System.Runtime.InteropServices.ComTypes

Assembly:

System.Runtime.InteropServices.dll

Localiza as 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 -> 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 ser procurado. Este é um parâmetro de entrada/saída.

lHashVal

Int32

Um valor de hash para acelerar a pesquisa, calculado pela função LHashValOfNameSys. Se lHashVal for 0, um valor será computado.

ppTInfo

ITypeInfo[]

Quando retorna, este método contém uma matriz de ponteiros para as descrições de tipo que contêm o nome especificado em szNameBuf. Este parâmetro é passado não inicializado.

rgMemId

Int32[]

Uma matriz do MEMBERID dos itens encontrados; rgMemId [i] é o MEMBERID que indexa na descrição de tipo especificada pelo ppTInfo [i]. Não pode ser null.

pcFound

Int16

Na entrada, indica o número de instâncias a serem pesquisadas. 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 in e out de pcFound forem idênticos, poderá haver mais descrições de tipo que contêm 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 pelo nome encontrado na biblioteca de tipos, usando o uso de maiúsculas e minúsculas encontrado na biblioteca de tipos. Por exemplo, se a biblioteca de tipos contiver o nome "aBc" e o FindName método passar "abc" como o parâmetro , szNameBuf se tornará "aBcszNameBuf" quando o método retornar.

Para obter mais informações, consulte Método ITypeLib::FindName.