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

Weitere Informationen

IPropertyStorage

IPropertyStorage::WriteMultiple

IPropertyStorage::WritePropertyNames