IM アプリケーションと Office の統合

[アーティクル]
04/04/2023

この記事では、プレゼンスの表示や連絡先カードからのインスタントメッセージの送信など、Office 2013、Office 2016、Office 2019、Office 365 のソーシャル機能と統合するように、インスタントメッセージ (IM) クライアントアプリケーションを構成する方法について説明します。

概要

Office 2013 (およびそれ以降のバージョン) には、Lync 2013 や Teams を含む IM クライアントアプリケーションとの統合機能が備わっています。この統合により、Word、Excel、PowerPoint、Outlook、Visio、Project、および OneNote の中から IM 機能を使用できるようになり、SharePoint ページでのプレゼンス統合も可能です。ユーザーは、連絡先リスト内でユーザーの写真、名前、プレゼンス状態、連絡先データを表示できます。 IM セッション、ビデオ通話、または電話による通話を連絡先カード (連絡情報と通信オプションが表示される Office の UI 要素) から直接開始することができます。 Office を使用すると、メールやドキュメントを使用しなくても、簡単に連絡先に接続できます。

注:

[!メモ] この記事では、コンピューターにインストールされた IM サービスと通信するアプリケーションを特に表すために、 IM クライアントアプリケーションという用語を使用します。たとえば、Lync 2013 および Teams は、IM クライアントアプリケーションと見なされます。この記事では、IM クライアントアプリケーションが IM サービスと通信する方法や、IM サービス自体については詳しく説明しません。

Office と通信できるように、IM のクライアントアプリケーションをカスタマイズすることができます。具体的には、Office UI 内に次の情報が表示されるように、IM のアプリケーションを変更できます。

連絡先の写真。
連絡先の名前。
連絡先の個人ステータスに関する注記。
連絡先のプレゼンスステータス。
連絡先の連絡可能性を示す文字列 (たとえば「連絡可能」や「退席中」など)。
連絡先の機能を示す文字列 (たとえば、「ビデオ準備完了」など)。
IM のワンクリック起動。
ビデオ通話のワンクリック起動。
電話通話のワンクリック起動 (SIP、電話番号、ボイスメール、新規番号の呼び出しを含む)。
連絡先の管理 (IM グループに追加)。
連絡先の場所とタイムゾーン。
連絡先データ、電話番号、電子メールアドレス、役職、および会社名。

図 1. Office 2013 での連絡先カード

Office 2013 のユーザーカード

Office とのこの統合を有効にするために、IM のクライアントアプリケーションは、Office に接続するために提供されている一連のインターフェイスを実装する必要があります。この統合の API は、Lync / Skype for Business を含むバージョンの Office 2013 と共にインストールされる Microsoft.Office.UC.dll ファイル内にある UCCollborationLib 名前空間に含まれています。 UCCollaborationLib 名前空間には、Office と統合するために実装する必要のあるインターフェイスが含まれています。

重要

Lync 2013/Skype for Business には、必要なインターフェイスのタイプライブラリが埋め込まれています。サードパーティインテグレーターの場合、これは Lync 2013 と Skype for Business の両方が対象コンピューターにインストールされている場合にのみ動作します。 Office 標準を使用して統合している場合は、タイプライブラリを抽出して、対象コンピューターにインストールする必要があります。 Lync 2013 SDK には、Microsoft.Office.UC.dll ファイルが含まれています。

注:

少数の Office 2010 アプリケーションは、同様に、次のサードパーティ IM プロバイダーのアプリケーションと統合できます: Outlook 2010、Word 2010、Excel 2010、PowerPoint 2010、および SharePoint Server 2010 (ActiveX コントロールを使用)。 Office 2013 との統合に必要な手順の多くは、Office 2010 にも同様に適用されます。 Office 2010 が IM プロバイダーアプリケーションと統合する方法には、いくつかの重要な相違があります。

Office 2010 には、連絡先の写真が表示されません。
Microsoft.Office.Uc.dll ファイルは、Office 2010 とは別にダウンロードする必要があります。 Lync 2010 SDK には、Office 2010 のための Microsoft.Office.UC.dll ファイルが含まれています。
Office アプリケーションが IM クライアントアプリケーションで IUCOfficeIntegration.GetAuthenticationInfo メソッドを呼び出すときには、文字列「14.0.0.0」が渡されます。
Office 2010 は、IM クライアントアプリケーションに接続した直後に、すべてのグループと連絡先を列挙します。

IM クライアントアプリケーションとの Office の統合方法

Office 2013 (またはそれ以降) アプリケーションは、起動するときに、以下のプロセスによって既定の IM クライアントアプリケーションと統合します。

レジストリをチェックして既定の IM クライアントアプリケーションを検出し、それに接続します。
IM クライアントアプリケーションでの認証を行います。
IM クライアントアプリケーションで公開されている特定のインターフェイスに接続します。
現在サインインしているユーザー (ローカルユーザー) の能力を判別します。これには、ユーザーの連絡先の取得、ユーザーのプレゼンスの判別、ユーザーの IM の能力 (インスタントメッセージング、ビデオチャット、VOIP、その他) の判別などが含まれます。
ローカルユーザーの連絡先のプレゼンス情報を取得します。
IM クライアントアプリケーションが終了するとき、Office アプリケーションは警告なしに切断します。

IM アプリケーションの検出

Office アプリケーションは、レジストリ内でいくつかの特定のキーとエントリを検索して、既定の IM クライアントアプリケーションを検出します。既定の IM クライアントアプリケーションが見つかった場合、それに接続しようとします。

Office アプリケーションが、既定の IM のクライアントアプリケーションを検出するためのプロセスは、次のとおりです。

Office アプリケーションは、レジストリで HKEY_CURRENT_USER\Software\IM Providers\DefaultIMApp サブキーが設定されているかを確認し、そこにリストされているアプリケーション名を読み取ります。
その後、Office アプリケーションは HKEY_CURRENT_USER\Software\IM Providers\ アプリケーション名\UpAndRunning を読み取り、その値の変更を監視します。
次に Office アプリケーションは HKEY_LOCAL_MACHINE\Software\IM Providers\ アプリケーション名 レジストリキーを読み取り、そこに格納されている ProcessName およびクラス ID (CLSID) の値を取得します。
IM クライアントアプリケーションは、その開始シーケンスを正常に完了し、すべてのクラスをプレゼンス統合のために正しく登録した後に、HKEY_CURRENT_USER\Software\IM Providers\ アプリケーション名\UpAndRunning キーを「2」に設定して、クライアントアプリケーションが実行中であることを示します。
Office アプリケーションは、HKEY_CURRENT_USER\Software\IM Providers\ アプリケーション名\UpAndRunning キーが「2」に設定されていることを検出すると、コンピューターで実行されるプロセスの一覧を調べて IM クライアントアプリケーションのプロセス名を見つけます。
Office アプリケーションが IM クライアントアプリケーションの使用するプロセスを検出すると、Office アプリケーションは CLSID を使用して CoCreateInstance を呼び出し、プロセス外 COM サーバーとして IM クライアントアプリケーションへの接続を確立します。

IM アプリケーションへの接続の認証

Office アプリケーションは、IM クライアントアプリケーションへの接続を確立した後に、以下を行います。

Office アプリケーションは、IUnknown::QueryInterface メソッドを呼び出して、 IUCOfficeIntegration インターフェースを検索します。
その後、Office アプリケーションは IUCOfficeIntegration.GetAuthenticationInfo メソッドを呼び出して、サポートされる最高の統合バージョン (たとえば、「15.0.0.0」) を渡します。
パラメーターとして渡された Office のバージョンを IM クライアントアプリケーションがサポートしている場合、アプリケーションは、以下のハードコーディングされた XML 文字列を呼び出し元のコードに返します。

<authenticationinfo>

注:

従来のものにも対応できるように、IM クライアントアプリケーションは、パラメーターとして渡された Office のバージョンをサポートしている場合、正確な値の <authenticationinfo> を GetAuthenticationInfo への呼び出しに戻す必要があります。
IM クライアントアプリケーションが値を返すことに失敗した場合、Office アプリケーションは、サポートされる次に高位の Office のバージョン (たとえば、「14.0.0.0」) を指定して GetAuthenticationInfo メソッドを再び呼び出します。
Office は、IM クライアントアプリケーションが IM とプレゼンス統合をサポートすると判断した後、必要なセットのインターフェイスに接続して初期化を完了します。 (詳細については、必要なインターフェイスへの接続を参照してください。

Office アプリケーションは、上記の手順のいずれかでエラーを検出するとバックアウトして、その Office アプリケーションのセッション中にはプレゼンス統合が再実行されません。

必要なインターフェイスへの接続

IM クライアントアプリケーションへの接続を認証した後、Office アプリケーションは、IM クライアントアプリケーションが公開する必要のある必要なインターフェイスのセットに接続しようとします。 Office アプリケーションは、以下を行ってこれを実行します。

Office アプリケーションは、 IUCOfficeIntegration.GetInterface メソッドを呼び出し、 oiInterfaceLyncClient 定数を UCCollaborationLib.OIInterface 列挙から渡して、 ILyncClient オブジェクトを取得します。
Office アプリケーションは、 IUCOfficeIntegration.GetInterface メソッドを呼び出し、 oiInterfaceAutomation 定数を OIInterface 列挙から渡して、 IAutomation オブジェクトを取得します。
Office アプリケーションは、_ILyncClientEvents イベントリスナーをセットアップします。
Office アプリケーションは、_IUCOfficeIntegrationEvents イベントリスナーをセットアップします。
Office アプリケーションは、 ILyncClient.State プロパティにアクセスして、IM クライアントアプリケーションからサインイン状態を取得します。
Office アプリケーションは、UCCollaborationLib.OIFeature 列挙からフラグを戻す IUCOfficeIntegration.GetSupportedFeatures メソッドを呼び出すことにより、IM クライアントアプリケーションの機能を取得します。
Office アプリケーションは、 ILyncClient.Self プロパティにアクセスして、 ISelf オブジェクトへの参照を取得します。

ローカルユーザーの能力を取得する

Office アプリケーションは、次の手順に従ってローカルユーザーの能力を取得します。

IM クライアントアプリケーションが IClient2 インターフェイスをサポートしている場合、Office は IClient2.PrivateContactManager プロパティにアクセスして、 IContactManager オブジェクトを取得しようとします。
IM アプリケーションが IClient2 インターフェイスをサポートしていない場合、Office アプリケーションは ILyncClient.ContactManager プロパティにアクセスして、 IContactManager オブジェクトを取得します。 IM クライアントアプリケーションは、他のいずれかの IM 機能を確立する前に、 IContactManager オブジェクトを正常に返す必要があります。
Office アプリケーションは、 ILyncClient.Uri プロパティにアクセスしてから、 IContactManager.GetContactByUri を呼び出して、ローカルユーザーに関連付けられている IContact オブジェクトを取得します。
その後、Office アプリケーションは複数の呼び出しを IContact.CanStart に対して実行してローカルユーザーの能力を確立し、 ModalityTypes.ucModalityInstantMessage と ModalityTypes.ucModalityAudioVideo の値を順次渡します。

連絡先プレゼンスの取得

Office アプリケーションは、以下を行うことにより、ローカルユーザーを含む連絡先プレゼンスを取得します。

Office アプリケーションは、 IContact.GetContactInformation を呼び出して、連絡先からプレゼンスアイテムを取得します。
その後、Office アプリケーションは、連絡先からのプレゼンス状態の変更をサブスクライブします。 IContactManager.CreateSubscription を呼び出して IContactSubscription オブジェクトを取得します。その後、 IContactSubscription.AddContact を呼び出して連絡先をサブスクリプションに追加し、 IContactSubscription.Subscribe を呼び出して連絡先の状態の変更を取得します。
IM アプリケーションが IContact2 をサポートしている場合、Office は IContact2.BatchGetContactInformation2 を呼び出してプレゼンス情報を取得しようとします。
その後、Office アプリケーションは、 IContact.BatchGetContactInformation を呼び出して連絡先のプレゼンスプロパティを取得します。 Office アプリケーションは、 IContact.Settings プロパティにアクセスして、プレゼンスプロパティの 2 つ目のセットを取得できます。
最後に、Office アプリケーションは IContact.CustomGroups プロパティにアクセスして、連絡先のグループメンバーシップを取得します。これにより、連絡先の属するすべての IGroup オブジェクトを含む、 IGroupCollection コレクションが返されます。

IM アプリケーションから切断する

Office アプリケーションが IM アプリケーションの OnShuttingDown イベントを検出すると、警告なしに切断します。ただし、IM アプリケーションよりも前に Office アプリケーションがシャットダウンする場合、Office アプリケーションは接続がクリーンアップされることを保証しません。 IM アプリケーションは、クライアント接続リークを処理する必要があります。

レジストリキーとエントリを設定する

前述のように、IM 対応の Office アプリケーションは、レジストリ内で特定のキー、エントリ、および値を検索して、接続する IM クライアントアプリケーションを検出します。これらのレジストリ値は、Office アプリケーションに、IM クライアントアプリケーションのオブジェクトモデルへのエントリポイントとして機能するクラスのプロセス名と CLSID を提供します (つまり、 IUCOfficeIntegration インターフェイスを実装するクラス)。 Office アプリケーションは、そのクラスを共同作成して、IM クライアントアプリケーションのプロセス外 COM サーバーに対するクライアントとして接続します。

表 1 を使用して、IM クライアントアプリケーションを Office と統合するためにレジストリに書き込む必要のあるキー、エントリ、および値を識別します。

表 1. 既定の IM クライアントアプリケーションを設定するレジストリキー

キー	エントリ	型	値	例
HKEY_LOCAL_MACHINE\Software\IM Providers\< アプリケーション名>	FriendlyName	REG_SZ	サードパーティ製の IM クライアントアプリケーションの名前。	Litware IM 2012
	ProcessName	REG_SZ	サードパーティ製の IM クライアントアプリケーションのプロセス名。	litware.exe
	GUID	REG_SZ	ルートのクラス ID (CLSID)、 IM アプリケーションでの共同作成可能なクラス ( IUCOfficeIntegration インターフェイスを実装するクラス)。	(A GUID)
HKEY_CURRENT_USER\Software\IM Providers	DefaultIMApp	REG_SZ	IM クライアントアプリケーションの名前。これは、HKEY_LOCAL_MACHINE の最上位レベルのレジストリキー (ハイブ) と同じ名前でなければなりません。	Litware
HKEY_CURRENT_USER\Software\IM Providers\< アプリケーション名>	UpAndRunning	REG_DWORD	0 ～ 2 の整数値。 0—実行していない 1—開始中 2—実行中注: アプリケーション名のレジストリキーは、DefaultIMApp エントリの値と同じである必要があります。

Office との統合のために必要なインターフェイスを実装する

UCCollaborationLib 名前空間には、Office と統合するために IM クライアントアプリケーションの実行可能ファイル (または COM サーバー) が実装する必要のある 3 つのインターフェイスがあります。これらのインターフェイスが実装されていない場合、Office アプリケーションは初期化プロセス中にバックアウトして、IM クライアントアプリケーションとの接続が確立されていません。

必要なインターフェイスは、次のとおりです。

IUCOfficeIntegration必須ではありませんが、 _IUCOfficeIntegrationEvents インターフェイスも同じ派生クラス内に実装される必要があります。
ILyncClient必須ではありませんが、 _ILyncClientEvents インターフェイスも同じ派生クラス内に実装される必要があります。
IAutomation

IUCOfficeIntegration インターフェイス

IUCOfficeIntegration インターフェイスは、Office アプリケーションが IM クライアントアプリケーションと接続するためのエントリポイントを提供します。このインターフェイスは、IM クライアントアプリケーションとの接続を開始するプロセスの一部として Office アプリケーションが呼び出す 3 つのメソッドを定義します。 IUCOfficeIntegration インターフェイスを実装するクラスは、Office がそのインスタンスを共同作成できるように、共同作成可能でなければなりません。さらに、HKEY_LOCAL_MACHINE\Software\IM Providers\ アプリケーション名 レジストリキーの GUID エントリの値として入力された CLSID を公開する必要があります。

IUCOfficeIntegration から継承するクラスも _IUCOfficeIntegrationEvents インターフェイスを実装する必要があります。 _IUCOfficeIntegrationEvents インターフェイスには、 IUCOfficeIntegration インターフェイスのイベントハンドラーを公開するメンバーが含まれています。

表 2 は、 IUCOfficeIntegration と _IUCOfficeIntegration から継承するクラスに実装されている必要のあるメンバーを示しています。

注:

IUCOfficeIntegration と _IUCOfficeIntegrationEvents インターフェイス、およびそのメンバーについて詳しくは、 UCCollaborationLib.IUCOfficeIntegration と UCCollaborationLib._IUCOfficeIntegrationEvents を参照してください。

表 2. IUCOfficeIntegration と _IUCOfficeIntegrationEvents インターフェイスの実装

インターフェイス	メンバー	説明
IUCOfficeIntegration	GetAuthenticationInfo メソッド	認証情報の文字列を取得します。
	GetInterface メソッド	特定のバージョンのインターフェイスを取得します。
	GetSupportedFeatures メソッド	サポートされている Office の統合機能を取得します。
_IUCOfficeIntegrationEvents	OnShuttingDown イベント	IM クライアントアプリケーションがシャットダウンしようとするときに発生するイベント。

次のコードを使用して、IM クライアントアプリケーション内の IUCOfficeIntegration と _IUCOfficeIntegration インターフェイスから継承するクラスを定義します。

// An example of a class that can be co-created and can integrate
// with Office as an IM provider.
[ClassInterface(ClassInterfaceType.None)]
[ComSourceInterfaces(typeof(_IUCOfficeIntegrationEvents))]
[Guid("{CLSID value}"), ComVisible(true)]
public class LitwareClientAppObject : IUCOfficeIntegration
{
    // Implementation details omitted.
}

GetAuthenticationInfo メソッドは、version パラメーターの引数として文字列を受け取ります。 Office アプリケーションは、このメソッドを呼び出すと、Office のバージョンに応じて引数の 2 つの文字列のいずれかで渡します。 Office アプリケーションがメソッドに IM クライアントアプリケーションでサポートされる (つまり機能がサポートされる) Office のバージョンを提供すると、GetAuthenticationInfo メソッドは、ハードコーディングされた XML 文字列「<authenticationinfo>」を返します。

次のコードを使用して、IM クライアントアプリケーションのコード内で GetAuthentication メソッドを実装します。

public string GetAuthenticationInfo(string _version)
{
    // Define the version of Office that the IM client application supports.
    string supportedOfficeVersion = "15.0.0.0";
    // Do a simple check for equivalency.
    if (supportedOfficeVersion == _version)
    {
        // If the version of Office is supported, this method must 
        // return the string literal "<authenticationinfo>" exactly.
        return "<authenticationinfo>";
    }
    else
    {
        return null;
    }
}

GetInterface メソッドは、インターフェイス パラメーターの引数として渡される内容に応じて、クラスへの参照を呼び出し元のコードにシャトルします。 Office アプリケーションは、 GetInterface メソッドを呼び出すと、インターフェイスパラメーター用に 2 つの値のいずれか、つまり UCCollaborationLib.OIInterface 列挙の oiInterfaceILyncClient 定数 (1) または oiInterfaceIAutomation 定数 (2) を渡します。 Office アプリケーションが oiInterfaceILyncClient 定数を渡すと、 GetInterface メソッドは ILyncClient インターフェースを実装するクラスへの参照を返します。 Office アプリケーションが oiInterfaceIAutomation 定数を渡すと、 GetInterface メソッドは IAutomation インターフェースを実装するクラスを返します。

次のコード例を使用して、IM クライアントアプリケーションのコード内で GetInterface メソッドを実装します。

public object GetInterface(string _version, OIInterface _interface)
{
    // These objects implement the ILyncClient or IAutomation 
    // interfaces respectively. There is no restriction on what these
    // classes are named.
    IMClient imClient = new IMClient();
    IMClientAutomation imAutomation = new IMClientAutomation();
    // Return different object references depending on the value passed in
    // for the _interface parameter.
    switch (_interface)
    {
        // The calling code is asking for an object that inherits
        // from ILyncClient, so it returns such an object.
        case OIInterface.oiInterfaceILyncClient:
        {
            return imClient;
        }
        // The calling code is asking for an object that inherits
        // from IAutomation, so it returns such an object.
        case OIInterface.oiInterfaceIAutomation:
        {
            return imAutomation;
        }
        default:
        {
            throw new NotImplementedException();
        }
    }
}

GetSupportedFeaturesメソッドは、IM クライアントアプリケーションによってサポートされる IM 機能に関する情報を返します。これは、その唯一のパラメーター version の文字列を受け取ります。 Office アプリケーションが GetSupportedFeatures メソッドを呼び出すと、メソッドは UCCollaborationLib.OIFeature 列挙からの値を返します。返される値は IM のクライアントの機能を示し、値にフラグを追加することによって、IM クライアントアプリケーションの各機能が Office アプリケーションに対して指定されます。

注:

Office 2013 (およびそれ以降) アプリケーションは、OIFeature 列挙の以下の定数を無視します。

oiFeaturePictures (2)
oiFeatureFreeBusyIntegration
oiFeaturePhoneNormalization

Office 365 バージョン 2011 (およびそれ以上) のアプリケーションは、OIFeature 列挙の以下の定数を無視します。

oiFeaturePictures (2)
oiFeaturePhoneNormalization

次のコード例を使用して、IM クライアントアプリケーションのコード内で GetSupportFeatures メソッドを実装します。

public OIFeature GetSupportedFeatures(string _version)
{
    OIFeature supportedFeature1 = OIFeature.oiFeatureQuickContacts;
    OIFeature supportedFeature2 = OIFeature.oiFeatureFastSearch;
    return (supportedFeature1 | supportedFeature2);
}

ILyncClient インターフェイス

ILyncClient インターフェイスは、IM クライアントアプリケーション自体の機能に対応しています。これは、アプリケーションにサインインしたユーザー ( UCCollaborationLib.ISelf インターフェイスによって表されるローカルユーザー)、アプリケーションの状態、ローカルユーザーの連絡先の一覧、および他のいくつかの設定を参照するプロパティを公開します。 IM のクライアントアプリケーションに接続しようとするとき、Office アプリケーションは ILyncClient インターフェイスを実装するオブジェクトへの参照を取得します。その参照から、Office は IM クライアントアプリケーションの機能の多くにアクセスできます。

さらに、 ILyncClient インターフェイスを実装するクラスは、 _ILyncClientEvents インターフェイスも実装する必要があります。 _ILyncClientEvents インターフェイスは、IM クライアントアプリケーションの状態を監視するために必要ないくつかのイベントを公開します。

表 3 は、ILyncClient と _ILyncClientEvents から継承するクラスに実装されている必要のあるメンバーを示しています。

注:

[!メモ] 表に記載されていない ILyncClient または _ILyncClientEvents インターフェイスのメンバーは、存在している必要がありますが、実装されている必要はありません。存在していても実装されていないメンバーは、NotImplementedException または E_NOTIMPL エラーをスローすることがあります。

ILyncClient と _ILyncClientEvents インターフェイス、およびそのメンバーの詳細については、「UCCollaborationLib.ILyncClient」および「UCCollaborationLib._ILyncClientEvents」を参照してください。

表 3. ILyncClient と ILyncClientEvents インターフェイスの実装

インターフェイス	メンバー	説明
ILyncClient	ContactManager プロパティ	連絡先グループマネージャーを取得します。
	ConversationManager プロパティ	会話マネージャーを取得します。
	Self プロパティ	Self オブジェクトを取得します。
	SignIn メソッド	特定の可用性を持つ IM クライアントアプリケーションのサインインプロセスを開始します。
	State プロパティ	現在のプラットフォーム状態を取得します。
	Uri プロパティ	IM クライアントアプリケーションの URI を取得します。
_ILyncClientEvents	OnStateChanged イベント	IM クライアントアプリケーションの状態が変化したときに発生します。このイベントを処理し、 eventData.NewState プロパティを取得する必要があります。アプリケーション内のいずれかのサブシステムで状態の変更が生じたとき、IM クライアントアプリケーションのインスタンスにバインドされているすべてのプロセスに対して、イベントが発生します。

初期化の処理中に、Office は ILyncClient.State プロパティにアクセスします。このプロパティは、 UCCollaborationLib.ClientState 列挙からの値を返す必要があります。

private ClientState _clientState;
public ClientState State
{
    get
    {
        return this._clientState;
    }
}

State プロパティは、IM クライアントアプリケーションの現在の状態を保管します。これは、IM アプリケーションのセッション全体で設定され、更新されている必要があります。 IM クライアントアプリケーションは、サインイン、サインアウト、またはシャットダウンするときに、 State プロパティを設定する必要があります。次の例で示すように、このプロパティは ILyncClient.SignIn と ILyncClient.SignOut メソッド内に設定することが最善です。

// This field is of a type that implements the 
// IAsynchronousOperation interface.
private IMClientAsyncOperation _asyncOperation = new IMClientAsyncOperation();
// This field is of a type that implements the ISelf interface.
private IMClientSelf _self;
public IMClientAsyncOperation SignIn(string _userUri, string _domainAndUser, 
    string _password, object _IMClientCallback, object _state)
{
    ClientState _previousClientState = this._clientState;
    this._clientState = ClientState.ucClientStateSignedIn;
    // The IMClientStateChangedEventData class implements the 
    // IClientStateChangedEventData interface.
    IMClientStateChangedEventData eventData = 
        new IMClientStateChangedEventData(_previousClientState, 
        this._clientState);
    if (_userUri != null)
    {
        // During the sign-in process, create a new contact with
        // the contact information of the currently signed-in user.
        this._self = new IMClientSelf(IMContact.BuildContact(_userUri));
    }
    // Raise the _ILyncClientEvents.OnStateChanged event.
    OnStateChanged(this, eventData as UC.ClientStateChangedEventData);
    
    return this._asyncOperation;
    }
}

次のコード例では、 ILyncClientEvents インターフェイスとIUCOfficeIntegrationEvents インターフェイスを使用してイベントリスナーを設定する方法を示します。

using Microsoft.Office.Uc;
using System;
using System.Runtime.CompilerServices;
using System.Runtime.InteropServices;
namespace SampleImplementation
{
    // Note: UCOfficeIntegration inherits from both IUCOfficeIntegration and _IUCOfficeIntegrationEvents_Event
    [ClassInterface(ClassInterfaceType.None), Guid("13c41ef9-eb90-4e94-8a7c-1e9d686bc019"), ComVisible(true)]
    [ComSourceInterfaces(typeof(_IUCOfficeIntegrationEvents))]
    public class MyInstantMessengerOfficeIntegration : UCOfficeIntegration
    {
        #region IUCOfficeIntegration implementation
        public string GetAuthenticationInfo(string _version)
        {
            return "";
        }
        public object GetInterface(string _version, OIInterface _interface)
        {
            return null;
        }
        public OIFeature GetSupportedFeatures(string _version)
        {
            return OIFeature.oiFeatureAddOneNoteToConversation;
        }
        #endregion
        #region _IUCOfficeIntegrationEvents support
        // This event implements void _IUCOfficeIntegrationEvents.OnShuttingDown();
        public event _IUCOfficeIntegrationEvents_OnShuttingDownEventHandler OnShuttingDown;
        // This method is called by the IM application when it is beginning to shut down.
        // The method will raise the OnShuttingDown event which is translated by .NET COM interop layer
        // into a call to _IUCOfficeIntegrationEvents.OnShuttingDown.
        // This notifies Office applications that the IM application is going away.
        internal void RaiseOnShuttingDownEvent()
        {
            if (this.OnShuttingDown != null)
            {
                this.OnShuttingDown();
            }
        }
        #endregion
    }
    // Note: LyncClient inherits from both ILyncClient and _ILyncClientEvents_Event
    // You must implement LyncClient because the event handlers in _ILyncClientEvents expect you to pass a LyncClient interface.
    [ComVisible(true)]
    [ComSourceInterfaces(typeof(_ILyncClientEvents))]
    public class MyInstantMessengerOfficeIntegration2 :
        Client,
        Client2,
        LyncClient
    {
        #region Interfaces
        public LyncClientCapabilityTypes Capabilities
        {
            get
            {
                throw new NotImplementedException();
            }
        }
        public ConferenceScheduler ConferenceScheduler
        {
            get
            {
                throw new NotImplementedException();
            }
        }
        public ContactManager ContactManager
        {
            get
            {
                throw new NotImplementedException();
            }
        }
        public ConversationManager ConversationManager
        {
            get
            {
                throw new NotImplementedException();
            }
        }
        public DelegatorClient[] DelegatorClients
        {
            get
            {
                throw new NotImplementedException();
            }
        }
        public DeviceManager DeviceManager
        {
            get
            {
                throw new NotImplementedException();
            }
        }
        public bool InSuppressedMode
        {
            get
            {
                throw new NotImplementedException();
            }
        }
        public ContactManager PrivateContactManager
        {
            get
            {
                throw new NotImplementedException();
            }
        }
        public RoomManager RoomManager
        {
            get
            {
                throw new NotImplementedException();
            }
        }
        public Self Self
        {
            get
            {
                throw new NotImplementedException();
            }
        }
        public ClientSettings Settings
        {
            get
            {
                throw new NotImplementedException();
            }
        }
        public SignInConfiguration SignInConfiguration
        {
            get
            {
                throw new NotImplementedException();
            }
        }
        public ClientState State
        {
            get
            {
                throw new NotImplementedException();
            }
        }
        public ClientType Type
        {
            get
            {
                throw new NotImplementedException();
            }
        }
        public string Uri
        {
            get
            {
                throw new NotImplementedException();
            }
        }
        public Utilities Utilities
        {
            get
            {
                throw new NotImplementedException();
            }
        }
        public ApplicationRegistration CreateApplicationRegistration(string _appGuid, string _appName)
        {
            throw new NotImplementedException();
        }
        public AsynchronousOperation Initialize(string _clientName, string _version = "0", string _clientShortName = "0", string _clientNameAbbreviation = "0", string _clientLongName = "0", SupportedFeatures _supportedFeatures = SupportedFeatures.ucAllFeatures, [IUnknownConstant] object _CommunicatorClientCallback = null, object _state = null)
        {
            throw new NotImplementedException();
        }
        public AsynchronousOperation Shutdown([IUnknownConstant] object _CommunicatorClientCallback, object _state)
        {
            throw new NotImplementedException();
        }
        public AsynchronousOperation SignIn(string _userUri = "0", string _domainAndUsername = "0", string _password = "0", [IUnknownConstant] object _CommunicatorClientCallback = null, object _state = null)
        {
            throw new NotImplementedException();
        }
        public AsynchronousOperation SignOut([IUnknownConstant] object _CommunicatorClientCallback, object _state)
        {
            throw new NotImplementedException();
        }
        #endregion
        #region _ILyncClientEvents support
        public event _ILyncClientEvents_OnStateChangedEventHandler OnStateChanged;
        public event _ILyncClientEvents_OnNotificationReceivedEventHandler OnNotificationReceived;
        public event _ILyncClientEvents_OnCredentialRequestedEventHandler OnCredentialRequested;
        public event _ILyncClientEvents_OnSignInDelayedEventHandler OnSignInDelayed;
        public event _ILyncClientEvents_OnCapabilitiesChangedEventHandler OnCapabilitiesChanged;
        public event _ILyncClientEvents_OnDelegatorClientAddedEventHandler OnDelegatorClientAdded;
        public event _ILyncClientEvents_OnDelegatorClientRemovedEventHandler OnDelegatorClientRemoved;
        // Notifies Office apps that the IM client state (signed out, signing in, singed in, signing out, etc) has changed.
        internal void RaiseOnStateChangedEvent(ClientStateChangedEventData eventData)
        {
            if (this.OnStateChanged != null)
            {
                this.OnStateChanged(this, eventData);
            }
        }
        // Notifies Office apps that the IM client has received a notification event from MAPI (e.g. autodiscover has finished)
        internal void RaiseOnNotificationReceivedEvent(LyncClientNotificationReceivedEventData eventData)
        {
            if (this.OnNotificationReceived != null)
            {
                this.OnNotificationReceived(this, eventData);
            }
        }
        // Notifies Office apps that the IM client has received a request for credentials for some operation (e.g. sign in, web search)
        internal void RaiseOnCredentialRequestedEvent(CredentialRequestedEventData eventData)
        {
            if (this.OnCredentialRequested != null)
            {
                this.OnCredentialRequested(this, eventData);
            }
        }
        // Notifies Office apps that the IM client has been delayed from signing in and gives an estimated delay time.
        internal void RaiseOnSignInDelayedEvent(SignInDelayedEventData eventData)
        {
            if (this.OnSignInDelayed != null)
            {
                this.OnSignInDelayed(this, eventData);
            }
        }
        // Notifies Office apps that the capabilities of this IM client have changed.
        internal void RaiseOnCapabilitiesChangedEvent(PreferredCapabilitiesChangedEventData eventData)
        {
            if (this.OnCapabilitiesChanged != null)
            {
                this.OnCapabilitiesChanged(this, eventData);
            }
        }
        // Notifies Office apps that a DelegatorClient object has been added to the IM client object.
        internal void RaiseOnDelegatorClientAdded(DelegatorClientCollectionEventData eventData)
        {
            if (this.OnDelegatorClientAdded != null)
            {
                this.OnDelegatorClientAdded(this, eventData);
            }
        }
        // Notifies Office apps that a DelegatorClient object has been removed from the IM client object.
        internal void RaiseOnDelegatorClientRemoved(DelegatorClientCollectionEventData eventData)
        {
            if (this.OnDelegatorClientRemoved != null)
            {
                this.OnDelegatorClientRemoved(this, eventData);
            }
        }
        #endregion
    }
}

IAutomation インターフェイス

IAutomation インターフェイスは、IM クライアントアプリケーションの機能を自動化します。これを使用して、会話を開始すること、会議に参加すること、および拡張機能ウィンドウのコンテキストを提供することができます。

表 4 は、 IAutomation から継承するクラスに実装されている必要のあるメンバーを示しています。

注:

表に記載されていない IAutomation インターフェイスのメンバーは、存在している必要がありますが、実装されている必要はありません。存在していても実装されていないメンバーは、NotImplementedException または E_NOTIMPL エラーをスローすることがあります。

IAutomation インターフェイスとそのメンバーの詳細については、「UCCollaborationLib.IAutomation」を参照してください。

表 4. IAutomation インターフェイスの実装

メンバー	説明
StartConversation メソッド	指定された会話モダリティを使用して会話を開始します。 IConversationWindow のインスタンスが返されます。

連絡先プレゼンス統合の実装

前述の 3 つの必須インターフェイスに加えて、Office での連絡先プレゼンス機能を有効にするために必要な他のいくつかのインターフェイスがあります。これらには、以下のものが含まれます。

IContact や IContact2 インターフェイス。
ISelf インターフェイス。
IContactManager と _IContactManagerEvents インターフェイス。
IGroup と IGroupCollection インターフェイス。
IContactSubscription インターフェイス。
IContactEndPoint インターフェイス。
ILocaleString インターフェイス

IContact インターフェイス

IContact インターフェイスは、IM クライアントアプリケーションのユーザーを表します。このインターフェイスは、ユーザーのプレゼンス、使用可能なモダリティ、グループメンバーシップ、および連絡先の種類のプロパティを公開します。別のユーザーとの会話を開始するには、そのユーザーに IContact のインスタンスを提供する必要があります。

表 5 は、 IContact から継承するクラスに実装されている必要のあるメンバーを示しています。

注:

表に記載されていない IContact インターフェイスのメンバーは、存在している必要がありますが、実装されている必要はありません。存在していても実装されていないメンバーは、NotImplementedException または E_NOTIMPL エラーをスローすることがあります。

IContact インターフェイスとそのメンバーの詳細については、「UCCollaborationLib.IContact」を参照してください。

表 5。 IContact インターフェイスの実装

メンバー	説明
CanStart メソッド	指定の種類のモダリティを連絡先で開始できる場合は、 true を返します。
GetContactInformation メソッド	発行連絡先から 1 つのプレゼンスアイテムを取得します。
BatchGetContactInformation メソッド	発行連絡先から複数のプレゼンスアイテムを取得します。
Settings プロパティ	連絡先プロパティのコレクションを取得します。
CustomGroups プロパティ	連絡先がメンバーとなっているグループのコレクションを取得します。

初期化プロセス中に、Office アプリケーションは IContact.CanStart メソッドを呼び出して、ローカルユーザーの IM 機能を判別します。 CanStart メソッドは、_modalityTypes パラメーターの引数として UCCollaborationLib.ModalityTypes 列挙からフラグを受け取ります。現在のユーザーが要求されたモダリティに関わることができる場合 (つまり、ユーザーにインスタントメッセージング、音声とビデオのメッセージング、またはアプリケーション共有の能力がある場合)、 CanStart メソッドは true を返します。

public bool CanStart(ModalityTypes _modalityTypes)
{
    // Define the capabilities of the current IM client application
    // user by using flags from the ModalityTypes enumeration.
    ModalityTypes userCapabilities = 
        ModalityTypes.ucModalityInstantMessage | 
        ModalityTypes.ucModalityAudioVideo | 
        ModalityTypes.ucModalityAppSharing;
    // Perform a simple test for equivalency.
    if (_modalityType == userCapabilities) 
    {
        return true;
    }
    else 
    {
        return false;
    }
}

GetContactInformation メソッドは、連絡先に関する情報を IContact オブジェクトから取得します。呼び出し元のコードは、取得するデータを示す _contactInformationType パラメーターの UCCollaborationLib.ContactInformationType 列挙型の値を渡す必要があります。

public object GetContactInformation(
    ContactInformationType _contactInformationType)
{
    // Determine the information to return from the contact's data based
    // on the value passed in for the _contactInformationType parameter.
    switch (_contactInformationType)
    {
        case ContactInformationType.ucPresenceEmailAddresses:
        {
            // Return the URI associated with the contact.
            string returnValue = this.Uri.ToLower().Replace("sip:", String.Empty);
            return returnValue;
        }
        case ContactInformationType.ucPresenceDisplayName:
        {
            // Return the display name associated with the contact.
            string returnValue = this._DisplayName;
            return returnValue;
        }
        default:
        {
            throw new NotImplementedException;
        }
        // Additional implementation details omitted.
    }
}

GetContactInformation と同様に、 BatchGetContactInformation メソッドは、連絡先に関する複数のプレゼンスアイテムを IContact オブジェクトから取得します。呼び出し元のコードは、_contactInformationTypes パラメーターの ContactInformationType 列挙体から値の配列を渡す必要があります。メソッドは、要求されたデータを含む UCCollaborationLib.IContactInformationDictionary オブジェクトを返します。

public IMClientContactInformationDictionary BatchGetContactInformation(
    ContactInformationType[] _contactInformationTypes)
{
    // The IMClientContactInformationDictionary class implements the
    // IContactInformationDictionary interface.
    IMClientContactInformationDictionary contactDictionary = 
        new IMClientContactInformationDictionary();
    foreach (ContactInformationType type in _contactInformationTypes)
    {
        // Call GetContactInformation for each type of contact 
        // information to retrieve. This code adds a new entry to
        // a Dictionary object exposed by the
        // ContactInformationDictionary property.
        contactDictionary.ContactInformationDictionary.Add(
            type, this.GetContactInformation(type));
    }
    return contactDictionary;
}

IContact.Settings プロパティは、連絡先についてのカスタムプロパティが含まれる IContactSettingDictionary オブジェクトを返します。

public IMClientContactSettingDictionary Settings
{
    get
    {
       // The IMClientContactSettingDictionary class implements
       // the IContactSettingDictionary interface.
       return new IMClientContactSettingDictionary();
    }
}

IContact.CustomGroups プロパティは、連絡先がメンバーとなっているすべてのグループを含む IGroupCollection オブジェクトを返します。

public IMClientGroupCollection CustomGroups
{
    get {
       // The IMClientGroupCollection class implements
       // the IGroupCollection interface.
        return new IMClientGroupCollection();
    }
}

ISelf インターフェイス

初期化プロセス中に、Office アプリケーションは ILyncClient.Self プロパティに アクセスして現在のユーザーのデータを取得します。このプロパティは ISelf オブジェクトを返す必要があります。 ISelf インターフェイスは、ローカルのサインイン済み IM クライアントアプリケーションユーザーを表します。

表 6 は、 ISelf から継承するクラスに実装されている必要のあるメンバーを示しています。

注:

[!メモ] 表に記載されていない ISelf インターフェイスのメンバーは、存在している必要がありますが、実装されている必要はありません。存在していても実装されていないメンバーは、NotImplementedException または E_NOTIMPL エラーをスローすることがあります。

表 6. ISelf インターフェイスの実装

メンバー	説明
Contact プロパティ	ローカルユーザーに関連付けられた IContact オブジェクトを取得します。

ローカルユーザーのプレゼンス、使用可能なモダリティ、グループメンバーシップ、および連絡先の種類のプロパティは、( IContact オブジェクトを返す) ISelf.Contact プロパティによって公開されます。初期化プロセス中に、Office アプリケーションは ISelf.Contact プロパティにアクセスして、ローカルユーザーの連絡先情報への参照を取得します。

次のコードを使用して、 Contact プロパティを実装する、 ISelf インターフェイスから継承するクラスを定義します。

[ComVisible(true)]
public class IMClientSelf : ISelf
{
    // Declare a private field to store contact data for local user.
    private IMClientContact _contactData;
    // In the constructor for the ISelf object, the calling code 
    // must supply contact data.
    public IMClientSelf (IMClientContact _selfContactData)
    {
        this._contactData = _selfContactData;
    }
    // When accessed, the Contact property returns a reference
    // to the IContact object that represents the local user.
    public IMClientContact Contact
    {
        get
        {
            return this._contactData as IMClientContact;
        }
    }
    // Additional implementation details omitted.
}

IContactManager と _IContactManagerEvents インターフェイス

IContactManager オブジェクトは、ローカルユーザー自身の連絡先情報を含む、ローカルユーザーの連絡先を管理します。 Office アプリケーションは、 IContactManager オブジェクトを使用して、ローカルユーザーの連絡先に対応する IContact オブジェクトにアクセスします。

表 7 は、 IContactManager と _IContactManagerEvents から継承するクラスに実装されている必要のあるメンバーを示しています。

注:

表に記載されていない IContactManager インターフェイスのメンバーは、存在している必要がありますが、実装されている必要はありません。存在していても実装されていないメンバーは、NotImplementedException または E_NOTIMPL エラーをスローすることがあります。

IContactManager と _IContactManagerEvents インターフェイス、およびそのメンバーの詳細については、「UCCollaborationLib.IContactManager」および「UCCollaborationLib._IContactManagerEvents」を参照してください。

表 7. IContactManager と _IContactManagerEvents インターフェイスの実装

インターフェイス	メンバー	説明
IContactManager	GetContactByUri メソッド	連絡先 URI を使用して、新しい連絡先インスタンスを検索または作成します。
	CreateSubscription メソッド	サブスクリプションやクエリのバッチ処理に使用できる ISubscription オブジェクトを作成します。
	Lookup メソッド	連絡先または配布グループを検索します。
_IContactManagerEvents	OnGroupAdded イベント	グループがグループコレクションに追加されると発生します。更新されたグループコレクションは、 IContactManager.Groups プロパティから取得できます。
	OnGroupRemoved イベント	グループがグループコレクションから除去されると発生します。更新されたグループコレクションは、 IContactManager.Groups プロパティから取得できます。
	OnSearchProviderStateChanged イベント	検索プロバイダーの状態が変化したときに発生します。

Office は IContactManager.GetContactByUri を呼び出して、連絡先の SIP アドレスを使用することにより、連絡先プレゼンス情報を取得します。 Active Directory の SIP アドレスに対して連絡先が構成されている場合、Office は連絡先のこのアドレスを決定し、 GetContactByUri を呼び出して、_contactUri パラメーターの連絡先の SIP アドレスを渡します。

Office は、連絡先の SIP アドレスを判別できないとき、 IContactManager.Lookup メソッドを呼び出して、IM サービスを使用することにより SIP を検索します。ここで、Office は検索できた最良のデータを連絡先に渡します (たとえば、連絡先のメールアドレスだけなど)。 Lookup メソッドは、非同期で AsynchronousOperation オブジェクトを返します。コールバックを呼び出すときに、 Lookup メソッドは連絡先の URI に加えて操作の成否も返します。

public IMClientContact GetContactByUri(string _contactUri)
{
    // Declare a Contact variable to contain information about the contact.
    IMClientContact tempContact = null;
    // The _groupCollections field is an IGroupCollection object. Iterate 
    // over each group in collection to see if the 
    // contact is a part of the group.
    foreach (IMClientGroup group in this._groupCollections)
    {
       if (group.TryGetContact(_contactUri, out tempContact))
       {
           break;
       }
    }
    // Check to see that the URI returned a valid contact. If it
    // did not, create a new contact.
    if (tempContact == null)
    {
        tempContact = IMClientContact.BuildContact(_contactUri);
    }
    // Return the contact to the calling code.
    return tempContact;
}

Office アプリケーションは、個々の連絡先のプレゼンスの変更をサブスクライブする必要があります。したがって、連絡先のプレゼンス状態が変化したとき、IM サーバーは、IM クライアントアプリケーションに警告を出すことにより、Office アプリケーションに警告します。これを行うには、Office アプリケーションが IContactManager.CreateSubscription メソッドを呼び出して、この要求に対する新しい IContactSubscription オブジェクトを作成します。

// Declare a private field to contain an IContactSubscription object.
private IMClientContactSubscription _contactSubscription;
// Return the IContactSubscription object associated 
// with the IContactManager object.
public IMClientContactSubscription CreateSubscription()
{
    return this._contactSubscription;
}

IGroup と IGroupCollection インターフェイス

IGroupオブジェクトは、集合的なグループ名によって連絡先のコレクションを特定するために、追加のプロパティを持つ連絡先のコレクションを表します。 IGroupCollection オブジェクトは、ローカルユーザーと IM クライアントアプリケーションで定義されている IGroup オブジェクトのコレクションを表します。 Office アプリケーションは IGroupCollection と IGroup オブジェクトを使用して、ローカルユーザーの連絡先にアクセスします。

表 9 は、以下の表の IGroup と IGroupCollection から継承するクラスに実装されている必要のあるメンバーを示しています。

注:

表に記載されていない IGroup インターフェイスのメンバーは、存在している必要がありますが、実装されている必要はありません。存在していても実装されていないメンバーは、NotImplementedException または E_NOTIMPL エラーをスローすることがあります。

IGroup と IGroupCollection インターフェイス、およびそのメンバーの詳細については、「UCCollaborationLib.IGroup」および「UCCollaborationLib.IGroupCollection」を参照してください。

表 9. IGroup と IGroupCollection インターフェイスの実装

インターフェイス	メンバー	説明
IGroupCollection	Count プロパティ	コレクションに含まれている IGroup オブジェクトの数を返します。
	Item プロパティ	コレクション内の指定のインデックス位置にある IGroup オブジェクトを返します。
IGroup	Id プロパティ	グループの ID を返します。

Office アプリケーションは、ローカルユーザーの情報を取得すると、 IGroupCollection オブジェクトを返す IContact.CustomGroups プロパティを呼び出すことにより、連絡先 (ローカルユーザー) のグループメンバーシップにアクセスします。 IGroupCollection には、 IGroup オブジェクトの配列 (または List) が含まれている必要があります。 IGroupCollection から派生するクラスは、コレクション内の項目数を返す Count プロパティ、およびコレクションから IGroup オブジェクトを返すインデクサーメソッド this(int) を公開する必要があります。

IContactSubscription インターフェイス

IContactSubscription インターフェイスによって、そのプレゼンス情報の更新を受け取る連絡先と通知をトリガーするプレゼンス情報の種類を指定できます。 Office アプリケーションは IContactSubscription オブジェクトを使用して、連絡先のプレゼンスステータスの情報を登録します。

表 10 は、 IContactSubscription から継承するクラスに実装されている必要のあるメンバーを示しています。

注:

表に記載されていない IContactSubscription インターフェイスのメンバーは、存在している必要がありますが、実装されている必要はありません。存在していても実装されていないメンバーは、NotImplementedException または E_NOTIMPL エラーをスローすることがあります。

IContactSubscription インターフェイスとそのメンバーの詳細については、「UCCollaborationLib.IContactSubscription」を参照してください。

表 10. IContactSubscription インターフェイスの実装

メンバー	説明
AddContact メソッド	サブスクリプションオブジェクトに連絡先を追加します。
Subscribe メソッド	IM クライアントアプリケーションが連絡先についてプレゼンスを監視するために役立ちます。

IContactSubscription インターフェイスには、配列または List を使用して、監視するすべての IContact オブジェクトへの参照を含める必要があります。 IContactSubscription.AddContact メソッドは、 IContactSubscription オブジェクトの基礎となるデータ構造のために IContact オブジェクトを追加することによって、プレゼンスの変更を監視する新しい連絡先を追加します。

// Store references to all of the IContact objects to subscribe to.
private List<IMClientContact> _subscribedContacts;
// Add a new IContact object to the collection of contacts.
public void AddContact(IMClientContact _contact)
{
    this._subscribedContacts.Add(_contact);
}

IContactSubscription.Subscribe メソッドにより、IM クライアントアプリケーションは、連絡先のプレゼンスオブザーバーにアクセスできます。それはポーリング戦略を使用して、IM クライアントアプリケーションがサブスクライブした連絡先について、サーバーからのプレゼンスを取得できます。 Subscribe メソッドは、ユーザーの連絡先リストの外部から (たとえば、大規模なパブリックネットワークから) プレゼンスが要求されている状況で役立ちます。

IContactEndPoint インターフェイス

IContactEndPoint は、連絡先の電話番号コレクションからの電話番号を表します。

表 11 は、 IContactEndPoint から継承するクラスに実装されている必要のあるメンバーを示しています。

注:

表に記載されていない IContactEndPoint インターフェイスのメンバーは、存在している必要がありますが、実装されている必要はありません。存在していても実装されていないメンバーは、NotImplementedException または E_NOTIMPL エラーをスローすることがあります。

IContactEndPoint インターフェイスとそのメンバーの詳細については、「UCCollaborationLib.IContactEndpoint」を参照してください。

表 11. IContactEndPoint インターフェイスの実装

メンバー	説明
DisplayName プロパティ	表示文字列を取得します。
Type プロパティ	連絡先のエンドポイントの種類を取得します。
Uri プロパティ	連絡先の URI を取得します。

ILocaleString インターフェイス

ILocaleString は、ローカライズされた文字列とローカリゼーションのロケール ID の両方を含む、ローカライズされた文字列構造です。 ILocaleString インターフェイスを使用して、連絡先カードのカスタムステータスの文字列を書式設定します。

表 12 は、 ILocaleString から継承するクラスに実装されている必要のあるメンバーを示しています。

注:

表に記載されていない ILocaleString インターフェイスのメンバーは、存在している必要がありますが、実装されている必要はありません。存在していても実装されていないメンバーは、NotImplementedException または E_NOTIMPL エラーをスローすることがあります。

ILocalString インターフェイスとそのメンバーの詳細については、「UCCollaborationLib.ILocaleString」を参照してください。

表 12. ILocaleString インターフェイスの実装

メンバー	説明
LocaleId プロパティ	ロケール ID を取得します。
Value プロパティ	文字列を取得します。

次の方法で共有

IM アプリケーションと Office の統合

概要

IM クライアントアプリケーションとの Office の統合方法

IM アプリケーションの検出

IM アプリケーションへの接続の認証

必要なインターフェイスへの接続

ローカルユーザーの能力を取得する

連絡先プレゼンスの取得

IM アプリケーションから切断する

レジストリキーとエントリを設定する

Office との統合のために必要なインターフェイスを実装する

IUCOfficeIntegration インターフェイス

ILyncClient インターフェイス

IAutomation インターフェイス

連絡先プレゼンス統合の実装

IContact インターフェイス

ISelf インターフェイス

IContactManager と _IContactManagerEvents インターフェイス

IGroup と IGroupCollection インターフェイス

IContactSubscription インターフェイス

IContactEndPoint インターフェイス

ILocaleString インターフェイス

関連項目

フィードバック

その他のリソース

次の方法で共有

IM アプリケーションと Office の統合

概要

IM クライアント アプリケーションとの Office の統合方法

IM アプリケーションの検出

IM アプリケーションへの接続の認証

必要なインターフェイスへの接続

ローカル ユーザーの能力を取得する

連絡先プレゼンスの取得

IM アプリケーションから切断する

レジストリ キーとエントリを設定する

Office との統合のために必要なインターフェイスを実装する

IUCOfficeIntegration インターフェイス

ILyncClient インターフェイス

IAutomation インターフェイス

連絡先プレゼンス統合の実装

IContact インターフェイス

ISelf インターフェイス

IContactManager と _IContactManagerEvents インターフェイス

IGroup と IGroupCollection インターフェイス

IContactSubscription インターフェイス

IContactEndPoint インターフェイス

ILocaleString インターフェイス

関連項目

フィードバック

その他のリソース

IM クライアントアプリケーションとの Office の統合方法

ローカルユーザーの能力を取得する

レジストリキーとエントリを設定する