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 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.