IAddrBook::CreateOneOff
適用対象: Outlook 2013 | Outlook 2016
1 回限りのアドレスのエントリ識別子を作成します。
HRESULT CreateOneOff(
LPSTR lpszName,
LPSTR lpszAdrType,
LPSTR lpszAddress,
ULONG ulFlags,
ULONG FAR * lpcbEntryID,
LPENTRYID FAR * lppEntryID
);
パラメーター
lpszName
[in]受信者の PR_DISPLAY_NAME (PidTagDisplayName) プロパティの値へのポインター。 lpszName パラメーターには NULL を指定できます。
lpszAdrType
[in]FAX や SMTP など、受信者のアドレスの種類へのポインター。 lpszAdrType パラメーターを NULL にすることはできません。
lpszAddress
[in]受信者のアドレスへのポインター。 lpszAddress パラメーターを NULL にすることはできません。
ulFlags
[in]1 回限りの受信者に影響を与えるフラグのビットマスク。 次のフラグを設定できます。
MAPI_SEND_NO_RICH_INFO
受信者は、書式設定されたメッセージ コンテンツを処理できません。 MAPI_SEND_NO_RICH_INFOが設定されている場合、MAPI は受信者の PR_SEND_RICH_INFO (PidTagSendRichInfo) プロパティを FALSE に設定します。 MAPI_SEND_NO_RICH_INFOが設定されていない場合、MAPI は、 lpszAddress によって指されている受信者のメッセージング アドレスがインターネット アドレスであると解釈されない限り、このプロパティを TRUE に設定します。 この場合、MAPI は PR_SEND_RICH_INFO を FALSE に設定します。
MAPI_UNICODE
表示名、アドレスの種類、住所は Unicode 形式です。 MAPI_UNICODE フラグが設定されていない場合、これらの文字列は ANSI 形式です。
lpcbEntryID
[out] lppEntryID パラメーターによって指されるエントリ識別子のバイト数へのポインター。
lppEntryID
[out]1 回限りの受信者のエントリ識別子へのポインターへのポインター。
戻り値
S_OK
1 回限りのエントリ識別子が正常に作成されました。
注釈
クライアントは CreateOneOff メソッドを呼び出して、1 回限りの受信者 (現在読み込まれているアドレス帳プロバイダーのコンテナーに属していない受信者) のエントリ識別子を作成します。 1 回限りの受信者は、セッションのアクティブなアドレス帳プロバイダーのいずれかでサポートされている任意の種類のアドレスを持つことができます。
1 回限りの受信者は、通常、特定のアドレスの種類のテンプレートを使用して作成されます。 アドレスの種類をサポートするアドレス帳プロバイダーは、テンプレートを提供します。 クライアント アプリケーションのユーザーが、関連する情報をテンプレートに入力します。
MAPI では、 CreateOneOff の表示名、アドレスの種類、アドレス パラメーターの Unicode 文字列がサポートされています。
MAPI_SEND_NO_RICH_INFO フラグは、リッチ テキスト形式 (RTF) の書式設定されたテキストを各メッセージと共に送信するかどうかを制御します。 トランスポート ニュートラル カプセル化形式 (TNEF) は、受信者が PR_SEND_RICH_INFO プロパティを設定する方法に関係なく、ほとんどのトランスポート プロバイダーによって送信されます。 これは、対人メッセージを処理するメッセージング クライアントの問題ではありません。 ただし、TNEF は通常、カスタム メッセージ クラスのカスタム プロパティを送信するために使用されるため、サポートされていないと、カスタム MAPI プロパティを必要とするフォーム ベースのクライアントやクライアントにとって問題になる可能性があります。 詳細については、「 TNEF を使用したメッセージの送信」を参照してください。
MFCMAPI リファレンス
MFCMAPI のサンプル コードについては、次の表を参照してください。
| ファイル | 関数 | コメント |
|---|---|---|
| Mapiabfunctions.cpp |
AddOneOffAddress |
MFCMAPI では 、CreateOneOff メソッドを使用して、アドレス帳に見つからないアドレスのエントリ ID を作成します。 |