IMetaDataImport::GetCustomAttributeByName-Methode (rometadataapi.h)
Hiermit wird das benutzerdefinierte Attribut abgerufen, wenn der Name oder Besitzer angegeben ist.
Syntax
HRESULT GetCustomAttributeByName(
[in] mdToken tkObj,
[in] LPCWSTR szName,
[out] const BYTE **ppData,
[out] ULONG *pcbData
);
Parameter
[in] tkObj
Ein Metadatentoken, das das Objekt darstellt, das das benutzerdefinierte Attribut besitzt.
[in] szName
Der Wert des benutzerdefinierten Attributs.
[out] ppData
Ein Zeiger auf ein Array von Daten, bei dem es sich um den Wert des benutzerdefinierten Attributs handelt.
[out] pcbData
Die Größe der in const zurückgegebenen Daten in Bytes.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Bemerkungen
Es ist zulässig, mehrere benutzerdefinierte Attribute für dieselben Besitzer*innen zu definieren. Sie können sogar denselben Namen aufweisen. GetCustomAttributeByName gibt jedoch nur einen instance zurück. (GetCustomAttributeByName gibt die erste instance zurück, auf die es trifft.) Um alle Instanzen eines benutzerdefinierten Attributs zu finden, rufen Sie die EnumCustomAttributes-Methode auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | rometadataapi.h |