IPropertyStorage::D eleteMultiple-Methode (propidl.h)

Artikel
03/01/2024

Die DeleteMultiple-Methode löscht so viele der angegebenen Eigenschaften, wie in diesem Eigenschaftensatz vorhanden sind.

Syntax

HRESULT DeleteMultiple(
  [in] ULONG             cpspec,
  [in] const PROPSPEC [] rgpspec
);

Parameter

[in] cpspec

Die numerische Anzahl der zu löschenden Eigenschaften. Der Wert dieses Parameters kann rechtlich auf 0 festgelegt werden, was jedoch den Zweck der Methode verfehlt, da dadurch keine Eigenschaften gelöscht werden, unabhängig vom in rgpspec festgelegten Wert.

[in] rgpspec

Zu löschende Eigenschaften. Eine Mischung aus Eigenschaftsbezeichnern und Zeichenfolgen-benannten Eigenschaften ist zulässig. Es können Duplikate vorhanden sein, und es ist nicht erforderlich, dass Eigenschaften in beliebiger Reihenfolge angegeben werden.

Rückgabewert

Diese Methode unterstützt zusätzlich zu Folgendem den Standardrückgabewert E_UNEXPECTED:

Hinweise

IPropertyStorage::D eleteMultiple muss so viele der angegebenen Eigenschaften löschen, wie im aktuellen Eigenschaftensatz enthalten sind. Wenn eine Stream- oder Speicherwerteigenschaft gelöscht wird, während diese Eigenschaft geöffnet ist, wird der Löschvorgang erfolgreich ausgeführt, und der zuvor zurückgegebene IStream - oder IStorage-Zeiger wird in den wiederhergestellten Zustand versetzt.

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

Freigeben über