IMAPISupport::NewEntry

[アーティクル]
04/04/2023

適用対象: Outlook 2013 | Outlook 2016

アドレス帳コンテナーまたは送信メッセージの受信者リストに、新しい受信者を直接追加します。

HRESULT NewEntry(
  ULONG_PTR ulUIParam,
  ULONG ulFlags,
  ULONG cbEIDContainer,
  LPENTRYID lpEIDContainer,
  ULONG cbEIDNewEntryTpl,
  LPENTRYID lpEIDNewEntryTpl,
  ULONG FAR * lpcbEIDNewEntry,
  LPENTRYID FAR * lppEIDNewEntry
);

パラメーター

ulUIParam

[in]ダイアログボックスの親ウィンドウへのハンドル。

ulFlags

[��]�\�񂳂�Ă��܂��B0 �ɂ��K�v��܂��B

cbEIDContainer

[in] lpEIDContainer パラメーターによって指されるエントリ識別子のバイト数。

lpEIDContainer

[in]新しいエントリを受け取るコンテナーのエントリ識別子へのポインター。 cbEIDContainer が 0 で lpEIDContainer が NULL の場合、NewEntry は IMAPISupport::CreateOneOff メソッドの呼び出しによって生成されるのと同じ型の 1 回限りのエントリ識別子を作成します。

cbEIDNewEntryTpl

[in] lpEIDNewEntryTpl パラメーターによって指されるエントリ識別子のバイト数。

lpEIDNewEntryTpl

[in]新しいエントリの作成に使用するテンプレートのエントリ識別子へのポインター。 cbEIDNewEntryTpl が 0 で lpEIDNewEntryTpl が NULL の場合、NewEntry は、ユーザーが新しいエントリを追加するためのテンプレートの一覧から選択できるようにするダイアログボックスを表示します。

lpcbEIDNewEntry

[out] lppEIDNewEntry パラメーターによって指されるエントリ識別子のバイト数へのポインター。

lppEIDNewEntry

[out]新しく作成されたエントリのエントリ識別子へのポインター。

戻り値

S_OK

新しいエントリが正常に作成されました。

注釈

IMAPISupport::NewEntry メソッドは、アドレス帳プロバイダーサポートオブジェクトに実装されます。アドレス帳プロバイダーは NewEntry を呼び出して、コンテナーに直接追加する新しいアドレス帳エントリを作成するか、送信メッセージのアドレス指定に使用します。

呼び出し側への注意

新しいエントリを特定のコンテナーに追加する場合は、 lpEIDContainer をコンテナーのエントリ識別子に設定し、 cbEIDContainer をエントリ識別子のバイト数に設定します。

新しいエントリを送信メッセージの受信者リストに追加する場合は、 lpEIDContainer を NULL に、 cbEIDContainer を 0 に設定します。

クライアントアプリケーションのユーザーが作成するエントリの種類を選択できるようにする場合は、cbEIDNewEntryTpl で 0 を渡し、lpEIDNewEntryTpl で NULL を渡します。 NewEntry には、MAPI の 1 回限りのテーブル、MAPI とセッションでサポートされている各アドレス帳プロバイダーのテンプレートの一覧が表示されます。各テンプレートは、1 つ以上のアドレスの種類の受信者エントリを作成できます。

新しいエントリのエントリ識別子を保持する場合は、 lpcbEIDNewEntry パラメーターと lppEIDNewEntry パラメーターに有効なポインターを渡します。 MAPIFreeBuffer 関数を呼び出すことで、このエントリ識別子を解放する必要があります。

特定のテンプレートを使用して、変更可能なコンテナーに新しいエントリを追加するには、次の手順を使用します。

IMAPISupport::OpenEntry メソッドを呼び出して宛先コンテナーを開き、lpEntryID パラメーターをコンテナーのエントリ識別子に設定します。
宛先コンテナーの IMAPIProp::OpenProperty メソッドを呼び出し、 ulPropTag パラメーターを PR_CREATE_TEMPLATES (PidTagCreateTemplates) に、 lpiid パラメーターを IID_IMAPITableに設定します。コンテナーは、新しいエントリの作成にサポートされているすべてのテンプレートを一覧表示する 1 回限りのテーブルを返します。
作成する特定の種類のエントリのテンプレートを表す行を取得します。 PR_ADDRTYPE (PidTagAddressType) 列は、テンプレートでサポートされているアドレスの種類を示します。
IMAPISupport::NewEntry を呼び出し、lpEIDNewEntryTpl パラメーターを選択したテンプレートのエントリ識別子に設定します。エントリ識別子は、1 回限りのテーブル内のテンプレートの行から PR_ENTRYID (PidTagEntryId) 列です。 cbEIDContainer で 0 を渡し、lpEIDContainer で NULL を渡します。新しいエントリのエントリ識別子を保持する場合は、 lppEIDNewEntry パラメーターに有効なポインターを渡します。

次の方法で共有

IMAPISupport::NewEntry

パラメーター

戻り値

注釈

呼び出し側への注意

関連項目

その他のリソース