IPropertySetStorage-eigenständige Implementierung

Die vom System bereitgestellte, eigenständige Implementierung von IPropertySetStorage enthält eine Implementierung von IPropertyStorage und IPropertySetStorage. IPropertyStorage ist die Schnittstelle, die Eigenschaften in einem Eigenschaften Satz-Speicher liest und schreibt. IPropertySetStorage ist die Schnittstelle, mit der Eigenschafts Sätze in einem Speicher erstellt und geöffnet werden. Die Schnittstellen ienumstatus propstg und ienumstatus propsetstg werden auch in der eigenständigen Implementierung bereitgestellt.

Um die eigenständige Implementierung von IPropertySetStoragezu verwenden, rufen Sie zunächst einen Zeiger auf die vom System bereitgestellte, eigenständige Implementierung ab, und ordnen Sie die vom System bereitgestellte Implementierung dem Speicher Objekt zu. Zum Abrufen eines Zeigers auf die eigenständige Implementierung von IPropertySetStorage müssen Sie die Funktion " stgkreatepropsetstg " aufrufen und den pstorage -Parameter angeben, der das Speicher Objekt angibt, das den Eigenschaften Satz enthalten soll. Diese Funktion stellt einen Zeiger auf die neue IPropertySetStorage -Schnittstelle für das angegebene Speicher Objekt bereit.

Die eigenständige Implementierung von IPropertySetStorage erstellt Eigenschafts Sätze für ein beliebiges Speicher Objekt, nicht nur für Verbund Dateispeicher. Die eigenständige Implementierung ist nicht von Verbund Dateien abhängig und kann mit jeder Implementierung strukturierter Speicher verwendet werden. Alle Einschränkungen der vom Aufrufer bereitgestellten strukturierten Speicher gelten für diese Implementierung von Eigenschaften Sätzen. Wenn Sie z. b. einen Speicher im einfachen Modus für stgopenpropstgbereitstellen, wird der resultierende IPropertySetStorage durch den bereitgestellten IStorageeingeschränkt.

Weitere Informationen zur Implementierung der Verbund Datei dieser Schnittstelle finden Sie im Abschnitt IPropertySetStorage-Verbund Datei Implementierung.

Verwendungs Zeitpunkt

Rufen Sie die Methoden von IPropertySetStorage auf, um Eigenschafts Sätze in strukturiertem Speicher zu erstellen, zu öffnen und zu löschen. Es gibt auch eine-Methode, die einen Zeiger auf den ienumstatus propsetstg -Enumerator bereitstellt, der zum Auflisten der Eigenschaften Sätze im Speicher verwendet werden kann.

Die eigenständige Implementierung stellt zusätzlich zu den Methoden " Create " und " Open " auch die Hilfsfunktionen " stgfoatepropstg " und " stgopenpropstg " bereit, um Eigenschafts Sätze zu erstellen und zu öffnen. Diese beiden Funktionen unterstützen den _ nicht gepufferten Wert propsetflag, sodass Sie Änderungen direkt in den Eigenschaften Satz schreiben können, anstatt Sie in einem Cache zu puffern. Weitere Informationen finden Sie unter propsetflag-Konstanten.

Methoden

Die eigenständige Implementierung von IPropertySetStorage unterstützt die folgenden Methoden.

IPropertySetStorage:: Create

Erstellt eine neue im Speicher festgelegte Eigenschaft und gibt einen Zeiger auf die IPropertyStorage -Schnittstelle für den Eigenschaften Satz zurück.

Wenn Sie den nicht gepufferten Wert "propsetflag" verwenden möchten _ , verwenden Sie stattdessen die Funktion " stgkreatepropstg ", um den neuen Eigenschaften Satz zu erstellen und zu öffnen und einen Zeiger auf die eigenständige Implementierung für die IPropertyStorage -Schnittstelle für den Eigenschaften Satz zu erhalten.

IPropertySetStorage:: Open

Öffnet eine vorhandene im Speicher festgelegte Eigenschaft und gibt einen Zeiger auf die IPropertyStorage -Schnittstelle für den Eigenschaften Satz zurück.

Wenn Sie den nicht gepufferten Wert "propsetflag" verwenden möchten _ , verwenden Sie stattdessen die Funktion " stgopenpropstg ", um einen Zeiger auf die eigenständige Implementierung von " IPropertyStorage " für den angegebenen Eigenschaften Satz zu erhalten.

IPropertySetStorage::D Elete

Löscht eine Eigenschaft, die in diesem Eigenschaften Satz Speicher festgelegt ist.

IPropertySetStorage:: Aufzählung

Erstellt ein-Objekt, das zum Auflisten von Status Wert-Strukturen verwendet werden kann. Jede Status-setstg -Struktur stellt Daten zu einem einzelnen Eigenschaften Satz bereit.

Hinweis

Die Eigenschaft "documentsummaryinformation" und "UserDefined" sind insofern eindeutig, als Sie möglicherweise zwei Eigenschaften Satz Abschnitte in einem einzelnen zugrunde liegenden Stream enthalten. Weitere Informationen finden Sie in den Eigenschaften Sätzen documentsummaryinformation und UserDefined .

 

IPropertyStorage-eigenständige Implementierung

IPropertySetStorage

IPropertyStorage

IStorage:: enumelements

Propsetflag-Konstanten

Status-setstg

Stgkreatepropsetstg

Stgkreatepropstg

Stgopenpropstg

STGM-Konstanten