Metodo ITypeLib::FindName (oaidl.h)

Articolo
03/05/2024

Individua le occorrenze di una descrizione dei tipi in una libreria dei tipi. Può essere usato per verificare rapidamente che un nome esista in una libreria dei tipi.

Sintassi

HRESULT FindName(
  [in, out] LPOLESTR  szNameBuf,
  [in]      ULONG     lHashVal,
  [out]     ITypeInfo **ppTInfo,
  [out]     MEMBERID  *rgMemId,
  [in, out] USHORT    *pcFound
);

Parametri

[in, out] szNameBuf

Nome da cercare.

[in] lHashVal

Valore hash per velocizzare la ricerca, calcolata dalla funzione LHashValOfNameSys . Se lHashVal = 0, viene calcolato un valore.

[out] ppTInfo

Matrice di puntatori alle descrizioni dei tipi che contengono il nome specificato in szNameBuf. Questo parametro non può essere null.

[out] rgMemId

Matrice degli elementi trovati; rgMemId[i] è l'ID MEMBRO che indicizza nella descrizione del tipo specificata da ppTInfo[i]. Questo parametro non può essere null.

[in, out] pcFound

In ingresso, indica il numero di istanze da ricercare. Ad esempio, *pcFound = 1 può essere chiamato per trovare la prima occorrenza. La ricerca viene arrestata quando ne viene trovata una.

In uscita, indica il numero delle istanze trovate. Se i valori in e out di *pcFound sono identici, potrebbero essere presenti più descrizioni dei tipi che contengono il nome.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_INVALIDARG	Uno o più argomenti non sono validi.
E_OUTOFMEMORY	Memoria insufficiente per completare l'operazione.

Commenti

Il passaggio di *pcFound = n indica che c'è spazio sufficiente nelle matrici ppTInfo e rgMemId per le coppie n (ptinfo, memid). La funzione restituisce MEMBERID_NIL in rgMemId[i], se il nome in szNameBuf è il nome delle informazioni sul tipo in ppTInfo[i].

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	oaidl.h

Vedi anche

Itypelib

Condividi tramite