ISyncMgrSyncItemInfo::IsConnected メソッド (syncmgr.h)

アイテム (通常は何らかの種類の外部デバイス) が接続されているかどうかを示す値を生成します。

構文

HRESULT IsConnected();

戻り値

型: HRESULT

項目が接続されている場合はS_OKを返します。それ以外の場合はS_FALSE。 このメソッドによって返されるエラーは、S_OKとして解釈されます。

注釈

アイテムが切断されている場合、同期センターによって同期されません。 また、項目で使用できるアクションの多く (同期など) は、UI で削除または無効になります。

この値は、フォルダー UI で System.Sync.Connected (PKEY_Sync_Connected) プロパティとして使用できます。

Sync Center は 、UpdateHandler メソッドが呼び出されるたびにこのメソッドを呼び出します。

例示

次の例は、プライベート クラス関数を呼び出して接続状態を取得するこのメソッドの実装を示しています。

STDMETHODIMP CMyDeviceSyncItem::IsConnected()
{
    return (_IsConnected() ? S_OK : S_FALSE);
}

Requirements