ITableData::HrEnumRow
Gilt für: Outlook 2013 | Outlook 2016
Ruft eine Zeile basierend auf ihrer Position in der Tabelle ab.
HRESULT HrEnumRow(
ULONG ulRowNumber,
LPSRow FAR * lppSRow
);
Parameter
ulRowNumber
[in] Die Nummer der Zeile, für die Eigenschaften zurückgegeben werden sollen. Der Wert im ulRowNumber-Parameter kann ein beliebiger Wert von 0 sein, der die erste Zeile in der Tabelle angibt, bis n - 1, was die letzte Zeile in der Tabelle angibt.
lppSRow
[out] Ein Zeiger auf einen Zeiger auf eine SRow-Struktur , die die Zielzeile beschreibt.
Rückgabewert
S_OK
Die Zeile wurde erfolgreich abgerufen, oder eine Zeile für die durch den ulRowNumber-Parameter angegebene Zeilennummer ist nicht vorhanden.
Hinweise
Die ITableData::HrEnumRow-Methode ruft eine Zeile basierend auf einer sequenziellen Zahl ab. Diese Zahl stellt die Reihenfolge der Einfügung dar (0 steht für die erste Zeile und die Anzahl der Zeilen minus 1 für die letzte Zeile). MAPI behält diese chronologische Reihenfolge der Zeileneinfügung für die Lebensdauer des Tabellendatenobjekts bei.
Wenn die in ulRowNumber angegebene Zahl keiner Zeile in der Tabelle entspricht, gibt HrEnumRow S_OK zurück und legt den lppSRow-Parameter auf NULL fest.
MAPI weist Arbeitsspeicher für die zurückgegebene SRow-Struktur zu, indem die MAPIAllocateBuffer-Funktion verwendet wird, wenn das Tabellendatenobjekt erstellt wird. Der Aufrufer muss diesen Speicher freigeben, indem er die MAPIFreeBuffer-Funktion aufruft.
Zum Abrufen von Zeilen aus einer Tabelle in der Reihenfolge, in der sie eingefügt wurden, rufen Benutzer des Tabellendatenobjekts die HrEnumRow-Methode auf.