Share via

ITypeInfo::GetNames-Methode (oaidl.h)

  • Artikel

Ruft die Variable mit der angegebenen Member-ID oder dem Namen der Eigenschaft oder Methode und den Parametern ab, die der angegebenen Funktions-ID entsprechen.

Syntax

HRESULT GetNames(
  [in]  MEMBERID memid,
  [out] BSTR     *rgBstrNames,
  [in]  UINT     cMaxNames,
  [out] UINT     *pcNames
);

Parameter

[in] memid

ID des Members, dessen Name bzw. Namen zurückgegeben werden sollen.

[out] rgBstrNames

Das vom Aufrufer zugewiesene Array. Bei der Rückgabe enthält jedes Element den Namen (oder Namen), der dem Element zugeordnet ist.

[in] cMaxNames

Die Länge des übergebenen rgBstrNames-Arrays .

[out] pcNames

Die Anzahl der Namen im rgBstrNames-Array .

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 muss das zurückgegebene BSTR-Array freigeben.

Wenn die Member-ID eine Eigenschaft identifiziert, die mit Eigenschaftenfunktionen implementiert wird, wird der Eigenschaftenname zurückgegeben. Bei Eigenschaft get-Funktionen werden immer die Namen der Funktion und deren Parameter zurückgegeben.

Bei Eigenschaften-Put- und -Put-Verweisfunktionen ist die rechte Seite der Zuweisung unbenannt. Wenn cMaxNames kleiner ist als erforderlich ist, um alle Namen der Parameter einer Funktion zurückzugeben, werden nur die Namen der ersten cMaxNames - 1 Parameter zurückgegeben. Die Namen der Parameter werden im Array in der gleichen Reihenfolge zurückgegeben, in der sie an anderer Stelle in der Schnittstelle angezeigt werden (z. B. dieselbe Reihenfolge im Parameterarray, das der FUNCDESC-Enumeration zugeordnet ist).

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

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile oaidl.h

Weitere Informationen

Itypeinfo