IMAPISupport::ModifyStatusRow
適用対象: Outlook 2013 | Outlook 2016
新しい行を追加するか、既存の行を変更して、状態テーブルを変更します。
HRESULT ModifyStatusRow(
ULONG cValues,
LPSPropValue lpColumnVals,
ULONG ulFlags
);
パラメーター
cValues
[in]新しいまたは変更された状態テーブルの行に含めるプロパティの数。
lpColumnVals
[in]新しい状態テーブル行または変更された状態テーブル行に列として含めるプロパティを記述するプロパティ値の配列へのポインター。
ulFlags
[in]状態テーブル行を定義する情報の処理方法を制御するフラグのビットマスク。 次のフラグを設定できます。
STATUSROW_UPDATE
lpColumnVals が指す配列に含まれるプロパティを、新しい行ではなく既存の状態テーブル行とマージするように MAPI に指示します。
戻り値
S_OK
状態テーブルが正常に更新されました。
注釈
IMAPISupport::ModifyStatusRow メソッドは、すべてのサービス プロバイダー サポート オブジェクトに対して実装されます。 サービス プロバイダーは、ログオン時に ModifyStatusRow を呼び出して、状態テーブルに行を追加し、セッション中に行を更新します。 ModifyStatusRow は、状態テーブルを構築するために必要な情報を MAPI に提供します。
呼び出し側への注意
ModifyStatusRow を呼び出して既存の状態テーブル行のプロパティを変更するときに、STATUSROW_UPDATE フラグを設定します。 これにより、変更される列のみが lpColumnVals パラメーターに渡されることを MAPI に通知します。
クライアントは、状態テーブルの情報を使用して、状態オブジェクトにアクセスできます。
状態テーブル行に含める必要がある列の完全な一覧については、「 状態テーブル」を参照してください。