Propsetflag-Konstanten
Die propsetflag-Konstanten definieren Merkmale eines Eigenschaften Satzes. Die in der folgenden Tabelle aufgeführten Werte werden im grfFlags -Parameter der IPropertySetStorage -Methoden, der stgkreatepropstg -Funktion und der stgopenpropstg -Funktion verwendet.
| Konstante/Wert | BESCHREIBUNG |
|---|---|
|
Wenn nicht angegeben, können standardmäßig nur einfache Eigenschaftswerte in den Eigenschaften Satz geschrieben werden. Durch die Verwendung einfacher Eigenschaftswerte wird verhindert, dass Eigenschaften Sätze in der Verbund Datei und eigenständige Implementierungen von IPropertySetStoragetransaktiv werden. Zu diesem Zweck müssen nicht-e-Eigenschaftswerte verwendet werden. |
|
Wenn angegeben, können nicht einfache Eigenschaftswerte in den Eigenschaften Satz geschrieben werden, und der Eigenschaften Satz wird in einem Speicher Objekt gespeichert. Nicht einfache Eigenschaftswerte sind solche mit dem VarType-Wert des VT- _ Speichers, dem VT- _ Stream, dem gespeicherten VT- _ _ Objekt oder dem VT- _ Streaming- _ Objekt. Wenn dieses Flag nicht angegeben wird, können nicht einfache Typen nicht in den Eigenschaften Satz geschrieben werden. In der Verbund Datei und in eigenständigen Implementierungen können Eigenschafts Sätze nur dann transaktiv sein, wenn propsetflag _ nonsimple angegeben wird. |
|
Wenn angegeben, werden alle Zeichen folgen Werte im Eigenschaften Satz, die nicht explizit Unicode sind, d. h. die anderen als VT _ LPWSTR, mit der aktuellen System-ANSI-Codepage gespeichert. Weitere Informationen finden Sie unter GetACP. Die Verwendung dieses Werts ist nicht empfehlenswert. Weitere Informationen finden Sie in den Hinweisen. Wenn dieser Wert nicht vorhanden ist, werden Zeichen folgen Werte im neuen Eigenschaften Satz in Unicode gespeichert. Der Grad an Kontrolle, den dieser Wert bereitstellt, ist erforderlich, damit Clients, die die Eigenschaften bezogenen Schnittstellen verwenden, mit Standard Eigenschafts Sätzen interagieren können, wie z. b. den OLE2-Zusammenfassungs Informationen, die möglicherweise in der ANSI-Codepage |
|
Wird nur mit den Funktionen " stgkreatepropstg " und " stgopenpropstg " verwendet. Das heißt, in den eigenständigen Implementierungen von Eigenschaften Satz Schnittstellen. Wenn Sie in diesen Funktionen angegeben sind, werden Änderungen am Eigenschaften Satz nicht gepuffert. Stattdessen werden Änderungen immer direkt in den Eigenschaften Satz geschrieben. Aufrufe an einen Eigenschaften Satz IPropertyStorage -Methoden ändern ihn. Allerdings werden Änderungen standardmäßig in einem internen Cache für die Eigenschaften Menge gepuffert und anschließend in den Eigenschaften Satz geschrieben, wenn die IPropertyStorage:: Commit -Methode aufgerufen wird. Durch das Festlegen von " propsetflag _ nicht gepuffert " wird die Leistung verringert, da der interne Puffer für die Eigenschaft automatisch nach jeder Änderung des Eigenschaften Satzes geleert wird. Das direkte Schreiben von Änderungen verhindert jedoch Probleme mit der Koordination. Beispielsweise, wenn das Speicher Objekt im transaktiven Modus geöffnet wird und der Eigenschaften Satz gepuffert wird. Wenn Sie dann die IStorage:: Commit -Methode für das Speicher Objekt aufzurufen, werden die Eigenschaften Satzänderungen nicht als Teil der Transaktion übernommen, da Sie sich in einem Puffer befinden, der noch nicht geleert wurde. Sie müssen IPropertyStorage:: Commit aufrufen, bevor Sie IStorage:: Commit aufrufen, um den Eigenschaften Satz Puffer zu leeren, bevor Sie die Änderungen an den Speicher übergeben. Als Alternative zum Durchführen von zwei aufrufen können Sie " propsetflag" als _ nicht gepuffert festlegen, sodass Änderungen immer direkt in den Eigenschaften Satz geschrieben und nie im internen Cache des Eigenschaften Satzes gepuffert werden. Anschließend werden die Änderungen übernommen, wenn ein Commit für den Transaktions Speicher ausgeführt wird. |
|
Bei Angabe dieser Eigenschaft wird die Groß-/Kleinschreibung beachtet. Eigenschaftsnamen mit Berücksichtigung von Groß-und Kleinschreibung sind nur im Eigenschaften Satz-Serialisierungsformat der Version 1 möglich Weitere Informationen finden Sie unter Eigenschaften Satz-Serialisierung. |
Bemerkungen
Diese Werte können festgelegt und mithilfe von bitweisen Vorgängen geprüft werden, die bestimmen, wie Eigenschafts Sätze erstellt und geöffnet werden. Eigenschafts Sätze werden mithilfe der IPropertySetStorage:: Create -Methode oder der stgkreatepropstg -Funktion erstellt. Sie werden mit der IPropertySetStorage:: Open -Methode oder der stgopenpropstg -Funktion geöffnet.
Es wird empfohlen, dass Eigenschaften Sätze als Unicode erstellt werden, indem das propsetflag- _ ANSI -Flag nicht im grfFlags -Parameter festgelegt wird. Es wird außerdem empfohlen, die Verwendung von VT _ LPSTR-Werten zu vermeiden und _ stattdessen VT LPWSTR-Werte zu verwenden. Wenn die-Eigenschaften Satz-Codepage Unicode ist, _ werden VT LPSTR-Zeichen folgen Werte in Unicode konvertiert, wenn Sie gespeichert werden, und beim Abrufen zurück in Multibytezeichen-Zeichen folgen Werte konvertiert. Wenn die Codepage des Eigenschaften Satzes nicht Unicode ist, werden Eigenschaftsnamen, VT _ BSTR-Zeichen folgen und nicht einfache Eigenschaftswerte in Multibytezeichen-Zeichen folgen konvertiert, wenn Sie gespeichert werden, und beim Abrufen wieder in Unicode konvertiert, wobei alle die aktuelle System-ANSI-Codepage verwenden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|