MAPINAMEID

適用対象: Outlook 2013 | Outlook 2016

名前付きプロパティについて説明します。

プロパティ
ヘッダー ファイル:
Mapidefs.h
typedef struct _MAPINAMEID
{
  LPGUID lpguid;
  ULONG ulKind;
  union
  {
    LONG lID;
    LPWSTR lpwstrName;
  } Kind;
} MAPINAMEID, FAR *LPMAPINAMEID;

メンバー

lpguid

特定のプロパティ セットを定義する GUID 構造体へのポインター。このメンバーを NULL にすることはできません。 有効な値は以下のとおりです。

PS_PUBLIC_STRINGS

PS_MAPI

クライアント定義値

ulKind

Kind メンバーの値の種類を記述する値。 有効な値は以下のとおりです。

MNID_ID

Kind メンバーには、プロパティ名を表す整数値が含まれています。

MNID_STRING

Kind メンバーには、プロパティ名を表す Unicode 文字列が含まれています。

Kind

名前付きプロパティの名前を記述する和集合。 名前は、 lID に格納される整数値、または lpwstrName に格納された Unicode 文字列のいずれかです。

注釈

MAPINAMEID 構造体は、0x8000に対して識別子を持つ名前付きプロパティを記述するために使用されます。 プロパティ セットは、名前付きプロパティの重要な部分です。 たとえば、PS_PUBLIC_STRINGSまたはPS_ROUTING_ADDRTYPEは MAPI によって定義されたプロパティ セットです。

名前付きプロパティを使用すると、クライアントは MAPI で定義されたプロパティ識別子の範囲で使用できるよりも大きな名前空間でカスタム プロパティを定義できます。 プロパティ名を使用してプロパティ値を直接取得することはできません。最初に、 IMAPIProp::GetIDsFromNames メソッドを使用してプロパティ識別子にマップする必要があります。 メッセージなどの特定のオブジェクトの場合、MAPI はカスタム プロパティのプロパティ識別子の範囲を予約します。 したがって、これらのオブジェクトの場合、クライアントは名前付きプロパティを使用する必要がないため、関連するオーバーヘッドを節約できます。

名前付きプロパティの詳細については、「 名前付きプロパティ」を参照してください。

関連項目

GUID

IMAPIProp::GetIDsFromNames

MAPI の構造