SetAttribIMsgOnIStg

適用対象: Outlook 2013 | Outlook 2016

OpenIMsgOnIStg 関数によって提供される IMessage オブジェクトのプロパティの属性を設定または変更します。

プロパティ	値
ヘッダー ファイル:	Imessage.h
実装元:	MAPI
呼び出し元:	クライアント アプリケーションとメッセージ ストア プロバイダー

HRESULT SetAttribIMsgOnIStg(
  LPVOID lpObject,
  LPSPropTagArray lpPropTags,
  LPSPropAttrArray lpPropAttrs,
  LPSPropProblemArray FAR * lppPropProblems
);

パラメーター

lpObject

[in]プロパティ属性が設定されているオブジェクトへのポインター。

lpPropTags

[in]プロパティ属性が設定されているプロパティを示すプロパティ タグの配列を含む SPropTagArray 構造体へのポインター。

lpPropAttrs

[in]設定するプロパティ属性を一覧表示する SPropAttrArray 構造体へのポインター。

lppPropProblems

[out]一連のプロパティの問題を含む、返された SPropProblemArray 構造体へのポインター。 この構造体は、 SetAttribIMsgOnIStg が一部のプロパティを設定できたが、すべてではない場合に発生する問題を識別します。 lppPropProblems パラメーターに NULL へのポインターが渡された場合、一部のプロパティが設定されていなくても、プロパティの問題の配列は返されません。

戻り値

S_OK

�ʘb���������A�\�������l�܂��͒l���Ԃ���܂��B

MAPI_W_ERRORS_RETURNED

呼び出しは全体的に成功しましたが、1 つ以上のプロパティにアクセスできず、PT_ERRORのプロパティ型で返されました。

注釈

プロパティ属性には、 IMAPIProp : IUnknown インターフェイスを実装するオブジェクトというプロパティ オブジェクトでのみアクセスできます。 OLE 構造化ストレージ オブジェクトで MAPI プロパティを使用できるようにするには、OpenIMsgOnIStg によって、OLE IStorage オブジェクトの上に IMessage : IMAPIProp オブジェクトがビルドされます。 このようなオブジェクトのプロパティ属性は 、SetAttribIMsgOnIStg で設定または変更でき、 GetAttribIMsgOnIStg で取得できます。

注GetAttribIMsgOnIStg および SetAttribIMsgOnIStg は、すべての IMessage オブジェクトで動作しません。 これらは、OpenIMsgOnIStg によって返される IMessage-on- IStorage オブジェクトに対してのみ有効です。

lpPropAttrs パラメーターでは、属性の数と位置は、lpPropTags パラメーターで渡されるプロパティ タグの数と位置と一致する必要があります。

SetAttribIMsgOnIStg 関数は、IMessage スキーマで必要な場合にメッセージ プロパティを読み取り専用にするために使用されます。 サンプル メッセージ ストア プロバイダーは、この目的で使用します。 詳細については、「 メッセージ」を参照してください。