ITableData::HrQueryRow
Gilt für: Outlook 2013 | Outlook 2016
Ruft eine Tabellenzeile ab.
HRESULT HrQueryRow(
LPSPropValue lpSPropValue,
LPSRow FAR * lppSRow,
ULONG FAR * lpuliRow
);
Parameter
lpSPropValue
[in] Ein Zeiger auf eine Eigenschaftswertstruktur, die die Indexspalte für die abzurufende Zeile beschreibt. Das ulPropTag-Element der Eigenschaftswertstruktur sollte das gleiche Eigenschaftstag wie der ulPropTagIndexColumn-Parameter aus dem Aufruf der CreateTable-Funktion enthalten, die auf die ITableData-Implementierung zugreift.
lppSRow
[out] Ein Zeiger auf einen Zeiger auf die abgerufene Zeile.
lpuliRow
[in, out] Bei der Eingabe ein gültiger Zeiger oder NULL, der angibt, dass keine Informationen zurückgegeben werden müssen. In der Ausgabe ein gültiger Zeiger, der auf die Zeilennummer der Zeile zeigt, eine sequenzielle Zahl, die die Position der Zeile in der Tabelle identifiziert.
Rückgabewert
S_OK
Die Zeile wurde erfolgreich abgerufen.
MAPI_E_INVALID_PARAMETER
Die SPropValue-Struktur , auf die lpSPropValue verweist, enthält nicht die Indexspalteneigenschaft.
Hinweise
Die ITableData::HrQueryRow-Methode ruft alle Eigenschaften für die Zeile ab, die über eine Indexspalte verfügt, die dem Wert der Indexspalte entspricht, die in der Eigenschaftenstruktur enthalten ist, auf die lpSPropValue verweist. HrQueryRow gibt auch die Zeilennummer zurück, wenn der Aufrufer sie anfordert, die die Position der Zeile in der Tabelle identifiziert.
Da HrQueryRow die SPropValue-Struktur , auf die lpSPropValue verweist, nicht ändert, müssen Aufrufer die Struktur freigeben, wenn HrQueryRow zurückgibt. Aufrufer müssen auch die SRow-Struktur freigeben, die die abgerufene Zeile enthält.