IMsgServiceAdmin::SetPrimaryIdentity
Область применения: Outlook 2013 | Outlook 2016
Указывает службу сообщений в качестве поставщика основного удостоверения для профиля.
HRESULT SetPrimaryIdentity(
LPMAPIUID lpUID,
ULONG ulFlags
);
Параметры
lpUID
[в] Указатель на структуру MAPIUID , содержащую уникальный идентификатор для службы сообщений для предоставления первичного удостоверения или NULL, который указывает, что SetPrimaryIdentity должен очистить текущее удостоверение.
ulFlags
[in] ���������������; ������ ���� ����� ����.
Возвращаемое значение
S_OK
Службе сообщений был успешно назначен поставщик первичного удостоверения.
MAPI_E_NO_ACCESS
SetPrimaryIdentity попытался назначить службу сообщений с флагом SERVICE_NO_PRIMARY_IDENTITY, заданным в свойстве PR_RESOURCE_FLAGS (PidTagResourceFlags).
Замечания
Метод IMsgServiceAdmin::SetPrimaryIdentity устанавливает службу сообщений в качестве поставщика основного удостоверения для профиля. Как правило, основным удостоверением является пользователь, вошедший в службу сообщений. Он представлен тремя свойствами:
PR_IDENTITY_DISPLAY (PidTagIdentityDisplay)
PR_IDENTITY_ENTRYID (PidTagIdentityEntryId)
PR_IDENTITY_SEARCH_KEY (PidTagIdentitySearchKey)
Каждый поставщик услуг в указанной службе сообщений задает для этих трех свойств отображаемое имя, идентификатор записи и ключ поиска пользователя обмена сообщениями, который предоставляет первичное удостоверение. Клиенты могут получить идентификатор записи первичного удостоверения, вызвав метод IMAPISession::QueryIdentity .
Свойство PR_RESOURCE_FLAGS имеет значение STATUS_PRIMARY_IDENTITY для каждого поставщика, который является членом службы сообщений, которая предоставляет основное удостоверение, и для SERVICE_PRIMARY_IDENTITY для службы сообщений. Если поставщик услуг не может предоставить основное удостоверение для своей службы сообщений, он задает PR_RESOURCE_FLAGS STATUS_NO_PRIMARY_IDENTITY. SetPrimaryIdentity задает свойство PR_RESOURCE_FLAGS каждой службы сообщений, которая не предоставляет основное удостоверение SERVICE_NO_PRIMARY_IDENTITY.
Каждый поставщик службы сообщений, о которых имеет сведения MAPI, может установить удостоверение для каждого из своих пользователей при входе клиента в службу. Однако, так как MAPI поддерживает подключения к нескольким поставщикам услуг для каждого сеанса MAPI, отсутствует четкое определение удостоверения конкретного пользователя для сеанса MAPI в целом. удостоверение пользователя зависит от того, какая служба используется. Клиенты могут вызывать SetPrimaryIdentity , чтобы назначить одно из многих удостоверений, установленных для пользователя службами сообщений, в качестве основного удостоверения для этого пользователя.