IMAPISupport::SetProviderUID
適用於:Outlook 2013 |Outlook 2016
註冊唯一代表服務提供者的 MAPIUID 結構。
HRESULT SetProviderUID(
LPMAPIUID lpProviderID,
ULONG ulFlags
);
參數
lpProviderID
[in] MAPIUID 結構的指標,可識別通訊簿或訊息存放區提供者。
ulFlags
保留;必須是零。
傳回值
S_OK
MAPIUID 結構已成功註冊。
註解
針對通訊簿和訊息存放區提供者支援對象實作 IMAPISupport::SetProviderUID 方法。 這些提供者會呼叫 SetProviderUID 來註冊 MAPIUID 結構中所描述的唯一標識碼,該結構是由 lpProviderID 所指向。 提供者會在建立的所有項目標識碼中包含此標識碼。
MAPI 會在將輸出訊息傳送至MAPI多任務緩衝處理器時使用 MAPIUID 結構,並判斷處理用戶端要求的適當提供者。 例如,當用戶端呼叫 IMAPISession::OpenEntry 方法時,MAPI 會檢查專案標識碼的 MAPIUID 部分、將它對應至傳遞給 SetProviderUID 的提供者,然後呼叫該提供者的 OpenEntry。
呼叫者注意事項
在登入時呼叫 SetProviderUID 以註冊 MAPIUID 結構。 MAPI 允許通訊簿和訊息存放區提供者註冊多個標識符。 當您多次呼叫 SetProviderUID 時,它一律會將 MAPIUID 結構新增至提供者的 MAPIUID 結構集合,即使 MAPIUID 重複也一樣。 SetProviderUID 無法移除 MAPIUID。