IMAPISupport::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、X500 など) へのポインター。 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 回限りのエントリ識別子が正常に作成されました。
注釈
IMAPISupport::CreateOneOff メソッドは、すべてのサービス プロバイダー サポート オブジェクトに対して実装されます。 サービス プロバイダーは CreateOneOff を呼び出して、1 回限りの受信者 (現在読み込まれているアドレス帳プロバイダーのコンテナーに属していない受信者) のエントリ識別子を作成します。
呼び出し側への注意
CreateOneOff によって返されるエントリ識別子の使用が完了したら、MAPIFreeBuffer 関数を使用して、エントリ識別子に割り当てられたメモリを解放します。
トランスポート プロバイダーに関する注意事項
トランスポート ニュートラル カプセル化形式 (TNEF) をサポートし、 PR_SEND_RICH_INFO プロパティの値を使用して、メッセージを転送するときに TNEF を使用するかどうかを判断します。 TNEF をサポートしていないか、要求されたときにこの形式でメッセージを送信しないと、フォーム ベースのクライアントまたはカスタム MAPI プロパティを必要とするクライアントで問題が発生する可能性があります。 これは、TNEF は通常、カスタム メッセージ クラスのカスタム プロパティを送信するために使用されるためです。