IAddrBook：：CreateOneOff
適用於：Outlook 2013 |Outlook 2016
建立一次性位址的項目標識碼。
HRESULT CreateOneOff(
LPSTR lpszName,
LPSTR lpszAdrType,
LPSTR lpszAddress,
ULONG ulFlags,
ULONG FAR * lpcbEntryID,
LPENTRYID FAR * lppEntryID
);
參數
lpszName
[in]PidTagDisplayName) 屬性 (收件者PR_DISPLAY_NAME值的指標。 lpszName 參數可以是 NULL。
lpszAdrType
[in]收件者地址類型的指標，例如FAX或 SMTP。 lpszAdrType 參數不能是 NULL。
lpszAddress
[in]收件者地址的指標。 lpszAddress 參數不能是 NULL。
ulFlags
[in]影響一次性收件者的旗標位掩碼。 您可以設定下列旗標：
MAPI_SEND_NO_RICH_INFO
收件者無法處理格式化的郵件內容。 如果設定MAPI_SEND_NO_RICH_INFO，MAPI 會將收件者的 PR_SEND_RICH_INFO (PidTagSendRichInfo) 屬性設定為 FALSE。 如果未設定MAPI_SEND_NO_RICH_INFO，除非 lpszAddress 所指向的收件者訊息地址解譯為因特網地址，否則 MAPI 會將此屬性設定為 TRUE。 在此情況下，MAPI 會將PR_SEND_RICH_INFO 設為 FALSE。
MAPI_UNICODE
顯示名稱、位址類型和位址都是 Unicode 格式。 如果未設定MAPI_UNICODE旗標，則這些字串為 ANSI 格式。
lpcbEntryID
[out] lppEntryID 參數所指向之專案標識碼中位元組計數的指標。
lppEntryID
[out]一次性收件者之專案標識碼指標的指標。
傳回值
S_OK
已成功建立一次性項目標識碼。
註解
用戶端會呼叫 CreateOneOff 方法，為一次性收件者建立專案標識碼，此收件者不屬於任何目前載入通訊簿提供者的任何容器。 一次性收件者可以擁有會話的其中一個使用中通訊簿提供者所支援的任何位址類型。
一次性收件者通常會使用其特定位址類型的範本來建立。 支援地址類型的通訊錄提供者會提供範本。 用戶端應用程式的使用者會在範本中輸入相關信息。
MAPI 針對 CreateOneOff 的顯示名稱、位址類型和地址參數支援 Unicode 字元字串。
MAPI_SEND_NO_RICH_INFO旗標會控制是否連同每個訊息一起傳送 RTF (RTF) 格式化文字。 不論收件者如何設定其PR_SEND_RICH_INFO屬性，大部分的傳輸提供者都會傳送傳輸中性封裝格式 (TNEF) ， 這是用來傳輸格式化文字 的 格式。 對於使用人際訊息的訊息用戶端而言，這不是問題。 不過，因為 TNEF 通常用來傳送自定義訊息類別的自定義屬性，所以對於需要自定義 MAPI 屬性的窗體型用戶端或用戶端而言，不支援它可能是個問題。 如需詳細資訊，請 參閱使用 TNEF 傳送訊息。
MFCMAPI 參考
如需 MFCMAPI 範例程式代碼，請參閱下表。
| 檔案 | Function | Comment |
|---|---|---|
| Mapiabfunctions.cpp |
AddOneOffAddress |
MFCMAPI 會使用 CreateOneOff 方法，為任何通訊錄中找不到的位址建立專案標識碼。 |