FPropContainsProp

  • Artikel

Gilt für: Outlook 2013 | Outlook 2016

Vergleicht zwei Eigenschaftswerte, in der Regel Zeichenfolgen oder binäre Arrays, um festzustellen, ob einer das andere enthält.

Eigenschaft Wert
Headerdatei
 Mapiutil.h
Implementiert von:
 MAPI
Aufgerufen von:
 Clientanwendungen und Dienstanbieter
 
BOOL FPropContainsProp(
  LPSPropValue lpSPropValueDst,
  LPSPropValue lpSPropValueSrc,
  ULONG ulFuzzyLevel
);

Parameter

lpSPropValueDst

[in] Zeiger auf eine SPropValue-Struktur, die den Eigenschaftswert definiert, der die Suchzeichenfolge enthalten kann, auf die der lpSPropValueSrc-Parameter verweist.

lpSPropValueSrc

[in] Zeiger auf eine SPropValue-Struktur, die die Suchzeichenfolge definiert, die FPropContainsProp in dem Eigenschaftswert sucht, auf den der lpSPropValueDst-Parameter verweist.

ulFuzzyLevel

[in] Optionseinstellungen, die die im Vergleich zu verwendende Genaukeitsstufe definieren.

  • Die unteren 16 Bits gelten für Eigenschaften vom Typ PT_BINARY und PT_STRING8. Sie müssen auf genau einen der folgenden Werte festgelegt werden:

    • FL_FULLSTRING: Die lpSPropValueSrc-Suchzeichenfolge muss dem von lpSPropValueDst identifizierten Eigenschaftswert entsprechen.

    • FL_PREFIX: Die lpSPropValueSrc-Suchzeichenfolge muss am Anfang des durch lpSPropValueDst identifizierten Eigenschaftswerts angezeigt werden. Die beiden Werte sollten nur bis zur Länge der durch lpSPropValueSrc angegebenen Suchzeichenfolge verglichen werden.

    • FL_SUBSTRING: Die lpSPropValueSrc-Suchzeichenfolge muss an einer beliebigen Stelle in dem von lpSPropValueDst identifizierten Eigenschaftswert enthalten sein.

  • Die oberen 16 Bits gelten nur für Eigenschaften vom Typ PT_STRING8. Sie 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 Nicht-Spacing-Zeichen wie diakritische Zeichen ignorieren.

    • FL_LOOSE: Der Vergleich sollte nach Möglichkeit eine Übereinstimmung anzeigen, wobei groß-/kleinschreibungsfreie Zeichen ignoriert werden.

Rückgabewert

TRUE

Die Parameter sind alle gültig, und die lpSPropValueSrc-Suchzeichenfolge ist wie im lpSPropValueDst-Eigenschaftswert angegeben enthalten.

FALSE

Die verglichenen Eigenschaftswerte sind nicht vom Typ PT_STRING8 oder PT_BINARY, die Eigenschaftswerte von unterschiedlichen Typen, oder die lpSPropValueSrc-Suchzeichenfolge ist nicht enthalten, wie im lpSPropValueDst-Eigenschaftswert angegeben.

Hinweise

Die Vergleichsmethode hängt von den Eigenschaftentypen ab, die in den SPropValue-Eigenschaftendefinitionen und der heuristischen Fuzzyebene im ulFuzzyLevel-Parameter angegeben sind. Die Funktionen FPropCompareProp und FPropContainsProp können verwendet werden, um Einschränkungen für das Generieren einer Tabelle vorzubereiten.

Die oberen 16 Bits von ulFuzzyLevel werden für Eigenschaftentypen PT_BINARY ignoriert. Wenn die Einstellungen in ulFuzzyLevel fehlen oder ungültig sind, wird eine genaue Übereinstimmung mit einer vollständigen Zeichenfolge durchgeführt. Weitere Informationen zum Einschluss von Eigenschaften finden Sie unter der SContentRestriction-Struktur .