IPropertyStorage::ReadPropertyNames-Methode (propidlbase.h)
Die ReadPropertyNames-Methode ruft alle vorhandenen Zeichenfolgennamen für die angegebenen Eigenschaften-IDs ab.
Syntax
HRESULT ReadPropertyNames(
[in] ULONG cpropid,
[in] const PROPID [] rgpropid,
[in, out] LPOLESTR [] rglpwstrName
);
Parameter
[in] cpropid
Die Anzahl der Elemente bei der Eingabe des Arrays rgpropid. Der Wert dieses Parameters kann auf 0 festgelegt werden, was jedoch den Zweck dieser Methode verfehlt, da dadurch keine Eigenschaftsnamen gelesen werden.
[in] rgpropid
Ein Array von Eigenschaften-IDs, für die Namen abgerufen werden sollen.
[in, out] rglpwstrName
Ein vom Aufrufer zugeordnetes Array der Größe cpropid von LPWSTR-Membern . Bei der Rückgabe füllt die Implementierung dieses Array aus. Ein gegebener Eintrag enthält entweder den entsprechenden Zeichenfolgennamen einer Eigenschafts-ID oder er kann leer sein, wenn die Eigenschaften-ID keine Zeichenfolgennamen enthält.
Jeder LPWSTR-Member des Arrays sollte mithilfe der CoTaskMemFree-Funktion freigegeben werden.
Rückgabewert
Diese Methode unterstützt zusätzlich zu Folgendem den Standardrückgabewert E_UNEXPECTED:
Hinweise
Für jede Eigenschafts-ID in der Liste der Eigenschaften-IDs, die im rgpropid-Array angegeben werden, ruft ReadPropertyNames den entsprechenden Zeichenfolgennamen ab, sofern vorhanden. Zeichenfolgennamen werden entweder durch Angeben der Namen in Aufrufen von IPropertyStorage::WriteMultiple beim Erstellen der Eigenschaft oder durch einen Aufruf von IPropertyStorage::WritePropertyNames erstellt. In beiden Fällen ist der Zeichenfolgenname optional, jedoch müssen alle Eigenschaften über eine Eigenschaften-ID verfügen.
Zeichenfolgennamen, die Eigenschaften-IDs zugeordnet sind, müssen innerhalb des Satzes eindeutig sein.
Anforderungen
Unterstützte Mindestversion (Client) | Windows 2000 Professional [Desktop-Apps | UWP-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [Desktop-Apps | UWP-Apps] |
Zielplattform | Windows |
Kopfzeile | propidlbase.h (include Objbase.h, Propidlbase.h) |
Bibliothek | Uuid.lib |
DLL | Ole32.dll |