ScCountProps
Gilt für: Outlook 2013 | Outlook 2016
Bestimmt die Größe eines Eigenschaftswertarrays in Bytes und überprüft den dem Array zugeordneten Arbeitsspeicher.
| Eigenschaft | Wert |
|---|---|
| Headerdatei |
Mapiutil.h |
| Implementiert von: |
MAPI |
| Aufgerufen von: |
Clientanwendungen und Dienstanbieter |
SCODE ScCountProps(
int cprop,
LPSPropValue rgprop,
ULONG FAR * pcb
);
Parameter
cprop
[in] Anzahl der Eigenschaften im Array, die durch den rgprop-Parameter angegeben werden.
rgprop
[in] Zeiger auf einen Bereich in einem Array von SPropValue-Strukturen , der die Eigenschaften definiert, deren Größe bestimmt werden soll. Dieser Bereich beginnt nicht unbedingt am Anfang des Arrays.
Pcb
[out] Optionaler Zeiger auf die Größe des Eigenschaftenarrays in Bytes.
Rückgabewert
S_OK
Der Aufruf erfolgreich ausgef�hrt und der erwartete Wert oder Werte zur�ckgegeben hat.
MAPI_E_INVALID_PARAMETER
Mindestens eine Eigenschaft im Eigenschaftenwertarray weist den Bezeichner PROP_ID_NULL oder PROP_ID_INVALID auf, oder das Eigenschaftenarray enthält eine mehrwertige Eigenschaft ohne Eigenschaftswerte.
Hinweise
Wenn NULL im pcb-Parameter übergeben wird, überprüft die ScCountProps-Funktion das Array von Benachrichtigungen, aber es wird keine Zählung durchgeführt. Wenn ein Wert ungleich NULL in pcb übergeben wird, bestimmt die ScCountNotifications-Funktion die Größe des Arrays und speichert die Ursache pcb. Der Pcb-Parameter muss groß genug sein, um das gesamte Array zu enthalten.
Während der Anzahl überprüft ScCountProps den dem Array zugeordneten Arbeitsspeicher. ScCountProps funktioniert nur mit Eigenschaften, zu denen MAPI Informationen enthält.