IPropertyStorage::ReadPropertyNames-Methode (propidl.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 zugewiesenes Array der Größe cpropid von LPWSTR-Membern . Bei der Rückgabe füllt die Implementierung dieses Array aus. Ein bestimmter Eintrag enthält entweder den entsprechenden Zeichenfolgennamen einer Eigenschafts-ID oder kann leer sein, wenn die Eigenschaften-ID keine Zeichenfolgennamen enthält.
Jedes LPWSTR-Element des Arrays sollte mithilfe der CoTaskMemFree-Funktion freigegeben werden.
Rückgabewert
Diese Methode unterstützt zusätzlich folgendes 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, aber alle Eigenschaften müssen über eine Eigenschafts-ID verfügen.
Zeichenfolgennamen, die Eigenschaften-IDs zugeordnet sind, müssen innerhalb der Gruppe eindeutig sein.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 | propidl.h (include Objbase.h, Propidlbase.h) |
| Bibliothek | Uuid.lib |
| DLL | Ole32.dll |