ITypeInfo::GetNames-Methode (oaidl.h)
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 |
|---|---|
|
Erfolg. |
|
Mindestens eines der Argumente ist ungültig. |
|
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 |