HrGetOneProp

適用対象: Outlook 2013 | Outlook 2016

プロパティインターフェイス ( つまり、IMAPIProp から派生したインターフェイス) から 1 つのプロパティの値を取得します。

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

HRESULT HrGetOneProp(
  LPMAPIPROP pmp,
  ULONG ulPropTag,
  LPSPropValue FAR * ppprop
);

パラメーター

Pmp

[in]プロパティ値の取得元となる IMAPIProp インターフェイスへのポインター。

ulPropTag

[in]取得するプロパティのプロパティタグ。

ppprop

[out]取得したプロパティ値を定義する、返された SPropValue 構造体へのポインターへのポインター。

MAPI_E_NOT_FOUND

要求されたプロパティは、指定したインターフェイスからは使用できません。

IMAPIProp::GetProps メソッドとは異なり、HrGetOneProp 関数は警告を返しません。取得するプロパティは 1 つだけであるため、単に成功または失敗します。複数のプロパティを取得する場合、 GetProps の方が高速です。

HrSetOneProp 関数を使用して、1 つのプロパティを設定または変更できます。

MFCMAPI のサンプルコードについては、次の表を参照してください。

ファイル	関数	コメント
MAPIFunctions.cpp	GetMAPIObjectType	MFCMAPI では、HrGetOneProp メソッドを使用してオブジェクトの型を取得します。