IPropertyStorage::SetClass-Methode (propidlbase.h)
Die SetClass-Methode weist dem aktuellen Eigenschaftsspeicherobjekt eine neue CLSID zu und speichert die CLSID dauerhaft mit dem -Objekt.
Syntax
HRESULT SetClass(
[in] REFCLSID clsid
);
Parameter
[in] clsid
Neue CLSID, die dem Eigenschaftensatz zugeordnet werden soll.
Rückgabewert
Diese Methode unterstützt zusätzlich folgendes den Standardrückgabewert E_UNEXPECTED:
Hinweise
Weist dem aktuellen Eigenschaftsspeicherobjekt eine CLSID zu. Die CLSID hat keine Beziehung zu den gespeicherten Eigenschaften-IDs. Durch Zuweisen einer CLSID kann ein Codeteil einem bestimmten instance eines Eigenschaftensatzes zugeordnet werden. Ein solcher Code kann z. B. die Benutzeroberfläche (UI) verwalten. Unterschiedliche CLSIDs können verschiedenen Eigenschaftensatzinstanzen zugeordnet werden, die über dieselbe FMTID verfügen.
Wenn der Eigenschaftssatz mit dem pclsid-Parameter der IPropertySetStorage::Create-Methode erstellt wird, die als NULL angegeben ist, wird die CLSID auf alle Nullen festgelegt.
Die aktuelle CLSID für ein Eigenschaftsspeicherobjekt kann mit einem Aufruf von IPropertyStorage::Stat abgerufen werden. Der Anfangswert für die CLSID kann bei der Erstellung des Speichers mit einem Aufruf von IPropertySetStorage::Create angegeben werden.
Durch Festlegen der CLSID auf einen nicht einfachen Eigenschaftensatz (eine, die rechtlich Speicher- oder Streamwerteigenschaften enthalten kann, wie in IPropertySetStorage::Create beschrieben), wird auch die CLSID für den zugrunde liegenden Unterspeicher festgelegt.
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 | propidlbase.h (include Objbase.h, Propidlbase.h) |
Bibliothek | Uuid.lib |
DLL | Ole32.dll |