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 |
|---|---|
|
Erfolg. |
|
Mindestens eines der Argumente ist ungültig. |
|
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 |