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

Weitere Informationen

IPropertyStorage

IPropertyStorage::WriteMultiple

IPropertyStorage::WritePropertyNames