ITypeLib::FindName-Methode (oaidl.h)

Sucht in einer Typbibliothek nach dem Vorkommen einer Typenbeschreibung. Dies kann verwendet werden, um schnell zu überprüfen, ob ein Name in einer Typbibliothek vorhanden ist.

Syntax

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

Parameter

[in, out] szNameBuf

Der zu suchende Name.

[in] lHashVal

Ein Hashwert zur Beschleunigung der Suche, der von der LHashValOfNameSys-Funktion berechnet wird. Wenn lHashVal = 0 ist, wird ein Wert berechnet.

[out] ppTInfo

Ein Array von Zeigern auf die Typbeschreibungen, die den in szNameBuf angegebenen Namen enthalten. Dieser Parameter darf nicht NULL sein.

[out] rgMemId

Ein Array der gefundenen Elemente; rgMemId[i] ist die MEMBERID, die in die von ppTInfo[i] angegebene Typbeschreibung indiziert wird. Dieser Parameter darf nicht NULL sein.

[in, out] pcFound

Zeigt bei einem Eintrag die Anzahl der zu suchenden Instanzen an. Beispielsweise kann *pcFound = 1 aufgerufen werden, um das erste Vorkommen zu finden. Die Suche wird beendet, wenn eine gefunden wird.

Gibt bei Beendigung der Suche die Anzahl der gefundenen Instanzen an. Wenn die Ein- und Auswertewerte von *pcFound identisch sind, gibt es möglicherweise weitere Typbeschreibungen, die den Namen enthalten.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
S_OK
Erfolg.
E_INVALIDARG
Mindestens eines der Argumente ist ungültig.
E_OUTOFMEMORY
Unzureichender Arbeitsspeicher, um den Vorgang abzuschließen.

Hinweise

Das Übergeben von *pcFound = n gibt an, dass in den PpTInfo - und rgMemId-Arrays für n-Paare (ptinfo, memid) genügend Platz vorhanden ist. Die Funktion gibt MEMBERID_NIL in rgMemId[i] zurück, wenn der Name in szNameBuf der Name der Typinformationen in ppTInfo[i] ist.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile oaidl.h

Weitere Informationen

Itypelib