IPropertyStorage::SetClass-Methode (propidl.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 zu Folgendem den Standardrückgabewert E_UNEXPECTED:
Hinweise
Weist dem aktuellen Eigenschaftsspeicherobjekt eine CLSID zu. Die CLSID hat keine Beziehung zu den gespeicherten Eigenschaften-IDs. Durch das Zuweisen einer CLSID kann ein Codeelement einem bestimmten instance eines Eigenschaftensatzes zugeordnet werden. Ein solcher Code kann z. B. die Benutzeroberfläche (UI) verwalten. Verschiedene 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 zum Zeitpunkt der Speichererstellung mit einem Aufruf von IPropertySetStorage::Create angegeben werden.
Durch Festlegen der CLSID für einen nicht einfachen Eigenschaftssatz (einer, der legal Speicher- oder Streamwerteigenschaften enthalten kann, wie unter 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 | propidl.h (include Objbase.h, Propidlbase.h) |
Bibliothek | Uuid.lib |
DLL | Ole32.dll |