IMsgServiceAdmin::SetPrimaryIdentity
適用対象: Outlook 2013 | Outlook 2016
メッセージ サービスをプロファイルのプライマリ ID のサプライヤーとして指定します。
HRESULT SetPrimaryIdentity(
LPMAPIUID lpUID,
ULONG ulFlags
);
パラメーター
lpUID
[in]プライマリ ID を提供するメッセージ サービスの一意識別子を含む MAPIUID 構造体へのポインター。または NULL。 これは、SetPrimaryIdentity が 現在の ID をクリアする必要があることを示します。
ulFlags
[����]�\��Ă��܂��B0 �ɂ���K�v������܂��B
戻り値
S_OK
メッセージ サービスは、プライマリ ID のサプライヤーに正常に割り当てられました。
MAPI_E_NO_ACCESS
SetPrimaryIdentity は、PR_RESOURCE_FLAGS (PidTagResourceFlags) プロパティにSERVICE_NO_PRIMARY_IDENTITY フラグが設定されているメッセージ サービスを指定しようとしました。
注釈
IMsgServiceAdmin::SetPrimaryIdentity メソッドは、プロファイルのプライマリ ID のサプライヤーとしてメッセージ サービスを確立します。 プライマリ ID は、通常、メッセージ サービスにログオンしているユーザーです。 これは、次の 3 つのプロパティで表されます。
PR_IDENTITY_DISPLAY (PidTagIdentityDisplay)
PR_IDENTITY_ENTRYID (PidTagIdentityEntryId)
PR_IDENTITY_SEARCH_KEY (PidTagIdentitySearchKey)
指定されたメッセージ サービス内のすべてのサービス プロバイダーは、これら 3 つのプロパティを、プライマリ ID を提供するメッセージング ユーザーの表示名、エントリ識別子、検索キーに設定します。 クライアントは、 IMAPISession::QueryIdentity メソッドを呼び出すことによって、プライマリ ID のエントリ識別子を取得できます。
PR_RESOURCE_FLAGS プロパティは、プライマリ ID を提供するメッセージ サービスのメンバーであるすべてのプロバイダーに対してSTATUS_PRIMARY_IDENTITYに設定され、メッセージ サービスのSERVICE_PRIMARY_IDENTITYに設定されます。 サービス プロバイダーがメッセージ サービスのプライマリ ID を指定できない場合は、 PR_RESOURCE_FLAGS を STATUS_NO_PRIMARY_IDENTITY に設定します。 SetPrimaryIdentity は、 プライマリ ID をSERVICE_NO_PRIMARY_IDENTITYに提供していない各メッセージ サービスの PR_RESOURCE_FLAGS プロパティを設定します。
MAPI に関する情報を持つ各メッセージ サービス プロバイダーは、クライアントがサービスにログオンするときに、各ユーザーの ID を確立できます。 ただし、MAPI は MAPI セッションごとに複数のサービス プロバイダーへの接続をサポートしているため、MAPI セッション全体に対する特定のユーザーの ID の明確な定義はありません。ユーザーの ID は、関係するサービスによって異なります。 クライアントは SetPrimaryIdentity を呼び出して、メッセージ サービスによってユーザーに対して確立された多数の ID のいずれかをそのユーザーのプライマリ ID として指定できます。