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

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