ITypeInfo::GetDllEntry-Methode (oaidl.h)

Artikel
02/29/2024

Ruft eine Beschreibung oder Angabe eines Einstiegspunkts für eine Funktion in einer DLL ab.

Syntax

HRESULT GetDllEntry(
  [in]  MEMBERID   memid,
  [in]  INVOKEKIND invKind,
  [out] BSTR       *pBstrDllName,
  [out] BSTR       *pBstrName,
  [out] WORD       *pwOrdinal
);

Parameter

[in] memid

Die ID der Memberfunktion, deren Beschreibung des DLL-Eintrags zurückgegeben werden soll.

[in] invKind

Die Art des durch memid identifizierten Members. Dies ist für Eigenschaften wichtig, da ein Memid bis zu drei separate Funktionen identifizieren kann.

[out] pBstrDllName

Wenn nicht NULL, legt die Funktion pBstrDllName auf den Namen der DLL fest.

[out] pBstrName

Wenn nicht NULL, legt die Funktion pBstrName auf den Namen des Einstiegspunkts fest. Wenn der Einstiegspunkt durch eine Ordnungszahl angegeben wird, ist dieses Argument NULL.

[out] pwOrdinal

Wenn nicht NULL und die Funktion durch eine Ordnungszahl definiert wird, legt die Funktion pwOrdinal auf die Ordnungszahl fest.

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

Der Aufrufer übergibt eine Member-ID, die die Memberfunktion darstellt, deren Eintragsbeschreibung gewünscht ist. Wenn die Funktion über einen DLL-Einstiegspunkt verfügt, werden der Name der DLL, die die Funktion enthält, sowie ihr Name oder Ordnungsbezeichner in den übergebenen Zeigern platziert, die vom Aufrufer zugewiesen werden. Wenn kein DLL-Einstiegspunkt für die Funktion vorhanden ist, wird ein Fehler zurückgegeben.

Wenn die Typbeschreibung von einer anderen Typbeschreibung erbt, ist diese Funktion rekursiv zur Basistypbeschreibung, falls erforderlich, um das Element mit der angeforderten Member-ID zu finden.

Der Aufrufer sollte SysFreeString verwenden, um die BSTRs frei zu geben, auf die von pBstrName und pBstrDllName verwiesen wird.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	oaidl.h

Weitere Informationen

Itypeinfo

Freigeben über