SContentRestriction
Gilt für: Outlook 2013 | Outlook 2016
Beschreibt eine Inhaltseinschränkung, die verwendet wird, um eine Tabellenansicht auf die Zeilen zu beschränken, die eine Spalte enthalten, deren Inhalt einer Suchzeichenfolge entspricht.
| Eigenschaft | Wert |
|---|---|
| Headerdatei |
Mapidefs.h |
typedef struct _SContentRestriction
{
ULONG ulFuzzyLevel;
ULONG ulPropTag;
LPSPropValue lpProp;
} SContentRestriction;
Members
ulFuzzyLevel
Optionseinstellungen, die die Genaukeitsstufe definieren, die die Inhaltseinschränkung erzwingen soll, wenn Sie eine Übereinstimmung überprüfen.
Die unteren 16 Bits des ulFuzzyLevel-Elements gelten für Eigenschaften vom Typ PT_BINARY und PT_STRING8 und müssen auf einen der folgenden Werte festgelegt werden:
FL_FULLSTRING: Um eine Übereinstimmung zu erhalten, muss die lpProp-Suchzeichenfolge in der eigenschaft enthalten sein, die durch ulPropTag identifiziert wird.
FL_PREFIX : Um eine Übereinstimmung zu finden, muss die lpProp-Suchzeichenfolge am Anfang der durch ulPropTag identifizierten Eigenschaft angezeigt werden. Die beiden Zeichenfolgen sollten nur bis zur Länge der durch lpProp angegebenen Suchzeichenfolge verglichen werden.
FL_SUBSTRING: Die lpProp-Suchzeichenfolge muss an einer beliebigen Stelle in der durch ulPropTag identifizierten Eigenschaft enthalten sein.
Die oberen 16 Bits des ulFuzzyLevel-Elements gelten nur für Eigenschaften vom Typ PT_STRING8 und können in beliebiger Kombination auf die folgenden Werte festgelegt werden:
FL_IGNORECASE: Der Vergleich sollte ohne Berücksichtigung der Groß-/Kleinschreibung erfolgen.
FL_IGNORENONSPACE: Der Vergleich sollte unicodedefinierte Nichtabstandszeichen wie diakritische Zeichen ignorieren.
FL_LOOSE: Der Vergleich sollte ihnen nach Möglichkeit eine Übereinstimmung liefern, wobei Groß-/Kleinschreibung und Zeichen ohne Abstände ignoriert werden.
ulPropTag
Eigenschaftstag, das die Zeichenfolgeneigenschaft identifiziert, die auf das Vorkommen der Suchzeichenfolge überprüft werden soll.
lpProp
Zeiger auf eine Eigenschaftswertstruktur, die den Zeichenfolgenwert enthält, der als Suchzeichenfolge verwendet werden soll.
Hinweise
Es gibt zwei Eigenschaftstags in einer SContentRestriction-Struktur : eines im ulPropTag-Member und das andere im ulPropTag-Member der SPropValue-Struktur , auf die von lpProp Verwiesen wird. In beiden Tags erfordert MAPI nur das Eigenschaftentypfeld und ignoriert das Eigenschaftenbezeichnerfeld. Die beiden Eigenschaftentypen müssen jedoch übereinstimmen. Andernfalls wird der Fehlerwert MAPI_E_TOO_COMPLEX zurückgegeben, wenn die Einschränkung in einem Aufruf von IMAPITable::Restrict oder IMAPITable::FindRow verwendet wird.
Die Werte FL_FULLSTRING, FL_PREFIX und FL_SUBSTRING schließen sich gegenseitig aus. Nur eine davon kann festgelegt werden, und eine davon muss festgelegt werden. Ihre Bedeutungen sind festgelegt, und der Anbieter muss sie genau wie definiert implementieren. Der Anbieter sollte MAPI_E_TOO_COMPLEX zurückgeben, wenn er diese Werte nicht unterstützen kann.
Die Werte FL_IGNORECASE, FL_IGNORENONSPACE und FL_LOOSE sind unabhängig. Zwischen null und allen drei kann festgelegt werden. Ihre Definitionen werden nur als Richtlinie bereitgestellt, und der Anbieter kann seine eigene spezifische Bedeutung jedes Flags implementieren. Der Anbieter sollte keine Fehleranzeige zurückgeben, wenn er über keine Implementierung eines angegebenen Flags verfügt.
Das Ergebnis einer Für eine Eigenschaft verhängten Inhaltsbeschränkung ist undefiniert, wenn die Eigenschaft nicht vorhanden ist. Wenn ein Client ein klar definiertes Verhalten für eine solche Einschränkung erfordert und nicht sicher ist, ob die Eigenschaft z. B. vorhanden ist, handelt es sich nicht um eine erforderliche Spalte einer Tabelle, sollte eine AND-Einschränkung erstellt werden, um die Inhaltseinschränkung mit einer exist-Einschränkung zu verbinden. Verwenden Sie eine SExistRestriction-Struktur , um die exist-Einschränkung und eine SAndRestriction-Struktur zu definieren, um die AND-Einschränkung zu definieren.
Weitere Informationen zur SContentRestriction-Struktur und einschränkungen im Allgemeinen finden Sie unter Informationen zu Einschränkungen.