DkmTransportConnection クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
これは、モニターと IDE の間の接続を表します。 モニターが IDE と同じプロセスで実行されている場合はローカル接続にすることも、リモート接続にすることもできます。 監視プロセスでは、接続は 1 つだけです。
派生クラス: DkmStandardRemoteTransportConnection
public ref class DkmTransportConnection : Microsoft::VisualStudio::Debugger::DkmDataContainer
[System.Runtime.InteropServices.Guid("37f756b6-9ea0-4c02-3f0a-99fb3a0f7a77")]
public class DkmTransportConnection : Microsoft.VisualStudio.Debugger.DkmDataContainer
[<System.Runtime.InteropServices.Guid("37f756b6-9ea0-4c02-3f0a-99fb3a0f7a77")>]
type DkmTransportConnection = class
inherit DkmDataContainer
Public Class DkmTransportConnection
Inherits DkmDataContainer
- 継承
- 継承
- 派生
- 属性
プロパティ
DebuggerCpuArchitecture |
モニター側デバッガー コンポーネントのアーキテクチャ。 これは、コンポーネント レベル < 100,000 のデバッガー コンポーネントです。 この API は、Visual Studio 17 RTM (DkmApiVersion.VS17RTM) で導入されました。 |
Flags |
基になる接続の特性を示すフラグ。 |
IsUnloaded |
このオブジェクトに対して 'unloaded' イベントが発生した場合 (例: DkmThread::Unload が呼び出されます)、またはオブジェクトが閉じている場合は true を返します。 同期なしでこの状態を確認する場合は、読み取った後に返される状態が正確でなくなる可能性があるため、注意が必要です。 (継承元 DkmDataContainer) |
Kind |
デバッグに使用されるトランスポートの種類を示します。 |
ProtocolVersion |
Visual Studio とターゲット コンピューターの間で使用されるプロトコルのバージョン。 これは、Visual Studio で認識されるプロトコル バージョンと、リモート デバッガーが認識するプロトコル バージョンの最小値です。 この API は、Visual Studio 11 Update 1 (DkmApiVersion.VS11FeaturePack1) で導入されました。 |
Qualifier |
[省略可能]接続先を示す文字列。 ローカル接続の場合、これは null になります。 既定のリモート デバッグの場合、これは接続しようとしているコンピューター名とポート番号です。 |
UniqueId |
この接続を一意に識別する Guid。 ローカル接続では、値 'DkmTransportKind.Local' が使用されます。 他の接続の値はランダムに生成されます。 |
メソッド
ActivateAppPackage(DkmWorkList, DkmPackagedAppPlatform, String, Boolean, DkmCompletionRoutine<DkmActivateAppPackageAsyncResult>) |
指定したパッケージ 化されたアプリケーションをアクティブにします。 これにより、まだ起動していない場合はアプリケーションが起動し、既に実行されている場合はアクティブなアプリケーションとしてアプリケーションが戻ります。 デバッガーで起動すると、この API の前に IDkmProcessLaunchNotifyListener.StartListener が呼び出されます。 このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元は、完了ルーチンを通じて要求が完了したことを通知されます。 |
ActivateAppPackageExtended(DkmWorkList, DkmPackagedAppPlatform, String, Boolean, DkmActivateAppPackageFlags, DkmCompletionRoutine<DkmActivateAppPackageAsyncResult>) |
指定したパッケージ 化されたアプリケーションをアクティブにします。 これにより、まだ起動していない場合はアプリケーションが起動し、既に実行されている場合はアクティブなアプリケーションとしてアプリケーションが戻ります。 デバッガーで起動すると、この API の前に IDkmProcessLaunchNotifyListener.StartListener が呼び出されます。 このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元は、完了ルーチンを通じて要求が完了したことを通知されます。 この API は、Visual Studio 14 Update 1 (DkmApiVersion.VS14Update1) で導入されました。 |
ActivateAppPackageOnTargetMonitor(DkmWorkList, DkmPackagedAppPlatform, String, Boolean, UInt32, DkmCompletionRoutine<DkmActivateAppPackageAsyncResult>) |
指定したモニターでパッケージ 化されたアプリケーションをアクティブにします。 これにより、まだ起動していない場合はアプリケーションが起動し、既に実行されている場合はアクティブなアプリケーションとしてアプリケーションが戻ります。 このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元は、完了ルーチンを通じて要求が完了したことを通知されます。 この API は、Visual Studio 12 Update 3 (DkmApiVersion.VS12Update3) で導入されました。 |
ActivateAppPackageWithStartupTask(DkmWorkList, String, Boolean, DkmCompletionRoutine<DkmActivateAppPackageAsyncResult>) |
指定したパッケージ 化されたアプリケーションをアクティブにします。 これにより、まだ起動していない場合はアプリケーションが起動し、既に実行されている場合はアクティブなアプリケーションとしてアプリケーションが戻ります。 デバッガーで起動すると、この API の前に IDkmProcessLaunchNotifyListener.StartListener が呼び出されます。 このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元は、完了ルーチンを通じて要求が完了したことを通知されます。 この API は、Visual Studio 14 RTM (DkmApiVersion.VS14RTM) で導入されました。 |
ActivateBackgroundTask(DkmWorkList, DkmAppPackageId, Int32, Guid, DkmCompletionRoutine<DkmActivateBackgroundTaskAsyncResult>) |
バックグラウンド タスクをアクティブ化します。 これは、開発者がアプリのアクティブ化ハンドラーをテストするために使用されます。 このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元は、完了ルーチンを通じて要求が完了したことを通知されます。 |
CreateCoreDumpParserTargetCompositionServices(String, Object) |
コア ファイル解析シナリオの IDebugServiceManager のインスタンスをCreateします。これは、ターゲットコンポジション ベースの拡張機能にアクセスするために使用できます。 DkmProcess が使用可能になったら、インスタンスを適切にキャッシュできるように、SetCoreDumpParserTargetCompositionServices を呼び出します。 場所の制約: ターゲットコンポジションインターフェイスはマシン間でマーシャリングすることはできませんが、使用可能な場合は安全に使用できます。 この API は、Visual Studio 16 Update 8 (DkmApiVersion.VS16Update8) で導入されました。 |
CreateDirectory(String) |
ターゲット コンピューター上にディレクトリを作成します。 ディレクトリは、ファイルのデプロイ時に暗黙的に作成されることに注意してください。 そのため、この API は、そのシナリオで使用する必要はありません。 |
DeleteFile(String) |
ターゲット コンピューター上のファイルを削除します。 |
DeployFile(String, String, Boolean) |
ターゲット コンピューターにファイルを展開します。 これにより、ファイルの内容と最後の書き込み時刻がコピーされますが、属性はコピーされないことに注意してください。 場所の制約: API は IDE コンポーネント (コンポーネント レベル > 100,000) から呼び出す必要があります。 |
DownloadFile(DkmWorkList, String, String, Boolean, DkmCompletionRoutine<DkmDownloadFileAsyncResult>) |
ターゲット コンピューターからファイルをダウンロードします。 これにより、ファイルの内容と最後の書き込み時刻がコピーされますが、属性はコピーされないことに注意してください。 このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元は、完了ルーチンを通じて要求が完了したことを通知されます。 場所の制約: API は IDE コンポーネント (コンポーネント レベル > 100,000) から呼び出す必要があります。 |
DownloadFile(String, String, Boolean) |
ターゲット コンピューターからファイルをダウンロードします。 これにより、ファイルの内容と最後の書き込み時刻がコピーされますが、属性はコピーされないことに注意してください。 場所の制約: API は IDE コンポーネント (コンポーネント レベル > 100,000) から呼び出す必要があります。 |
EnumerateBackgroundTasks(DkmWorkList, DkmAppPackageId, Int32, DkmCompletionRoutine<DkmEnumerateBackgroundTasksAsyncResult>) |
既存のバックグラウンド タスクを列挙します。 これは、開発者がアプリの列挙型ハンドラーをテストするために使用されます。 このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元は、完了ルーチンを通じて要求が完了したことを通知されます。 |
EnumPackages() |
インストール済みおよび起動可能な (アプリケーションを含むアプリ パッケージ) アプリ パッケージを列挙します。 場所の制約: API は IDE コンポーネント (コンポーネント レベル > 100,000) から呼び出す必要があります。 |
EnumRunningProcesses(Boolean, DkmRunningProcessInfoPropertyMask) |
ターゲット コンピューターで実行されているすべてのプロセス (デバッグされていないプロセスを含む) の一覧を提供します。 |
EnumRunningProcesses(DkmWorkList, Boolean, DkmRunningProcessInfoPropertyMask, DkmCompletionRoutine<DkmEnumRunningProcessesAsyncResult>) |
ターゲット コンピューターで実行されているすべてのプロセス (デバッグされていないプロセスを含む) の一覧を提供します。 このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元は、完了ルーチンを通じて要求が完了したことを通知されます。 |
ExtractFromDeployConnection(IVsDebuggerDeployConnection) |
デプロイ接続をバックする DkmTransportConnection オブジェクトを取得します。 これは、デバッガーデプロイ API からデバッガー エンジン (Dkm) API にブリッジするために使用できます。 たとえば、これを使用して DkmCustomMessages を送信できます。 基になる DkmTransportConnection が破棄されないように、呼び出し元は引き続き deployConnection を保持する必要があります。 既定では、コンコード コンポーネントはデバッグの停止中にアンロードされることに注意してください。 この動作は、コンポーネントの .vsdconfigxml ファイルで 'StayLoadedForDeployConnection="true"' を設定することで上書きできます。 これは、呼び出し元がカスタム メッセージを送信するためにデプロイ接続を抽出し、デバッガー セッションの終了後に行う場合に便利です。 |
ExtractFromPort(IDebugPort2) |
このポート オブジェクトをバックアップする DkmTransportConnection オブジェクトを取得します。 これは、ポートが現在接続されておらず、再接続が失敗した場合、リモート デバッグ シナリオでは失敗します。 この API は、Visual Studio のメイン スレッドからのみ正しく機能します。 |
FindConnection(Guid) |
DkmTransportConnection オブジェクトを検索します。 指定された入力キーを持つオブジェクトが存在しない場合、FindConnection は失敗します。 |
FindLiveProcess(Int32) |
この DkmTransportConnection 内で DkmProcess 要素を検索します。 指定された入力キーを持つ要素が存在しない場合、FindLiveProcess は失敗します。 オブジェクトが見つかった場合は、常に 'Live' パーツが含まれます。 |
FindProcess(Guid) |
この DkmTransportConnection 内で DkmProcess 要素を検索します。 指定された入力キーを持つ要素が存在しない場合、FindProcess は失敗します。 |
FindProductionConnection(Guid) |
この DkmTransportConnection 内で DkmProductionConnection 要素を見つけます。 指定された入力キーを持つ要素が存在しない場合、FindProductionConnection は失敗します。 この API は、Visual Studio 15 Update 2 (DkmApiVersion.VS15Update2) で導入されました。 |
FindRecordedProcessInfo(String) |
この DkmTransportConnection 内で DkmRecordedProcessInfo 要素を検索します。 指定された入力キーを持つ要素が存在しない場合、FindRecordedProcessInfo は失敗します。 この API は、Visual Studio 16 RTM (DkmApiVersion.VS16RTM) で導入されました。 |
FindSerializedProcessInfo(String) |
この DkmTransportConnection 内で DkmSerializedProcessInfo 要素を見つけます。 指定された入力キーを持つ要素が存在しない場合、FindSerializedProcessInfo は失敗します。 この API は、Visual Studio 16 Update 8 (DkmApiVersion.VS16Update8) で導入されました。 |
FlushClosedObjectQueue() |
この関数は、すべてのオブジェクト閉じる通知を強制的にモニター プロセスとすぐに交換するために使用されます。 'GC のように。マネージ コードで Collect' を指定すると、システムによってキューが自動的にフラッシュされるため、通常、この関数は不要です。 ただし、すべての更新プログラムをすぐに交換することが重要な場合は、この方法を使用できます。 特定のオブジェクトに対してコンポーネントが 'Close' を呼び出すと、オブジェクトのクローズ通知が作成 (およびキューに入れられます) されます。 モニター・プロセスとエンジン・プロセスの両方が、クローズされたオブジェクトのキューを保守します。 このメソッドはエンジン プロセスからのみ呼び出すことができますが、両方のキューをフラッシュするために使用されます。 場所の制約: API は IDE コンポーネント (コンポーネント レベル > 100,000) から呼び出す必要があります。 |
GetAppPackageExecutionState(DkmAppPackageId, Int32) |
Windows ストア アプリの実行状態を取得します。 このフィールドの値は、PACKAGE_EXECUTION_STATEで指定されます。 |
GetClrVersionOfExecutable(String) |
デバッガーが特定の実行可能ファイルを読み込む必要がある CLR のバージョン文字列を提供します。 戻り値は、実行可能ファイルの PE ヘッダー (exe が管理されている場合)、実行可能ファイルの構成ファイル、CLR 環境変数、およびレジストリ内のローダー ポリシーの内容に基づいています。 特にネイティブ実行可能ファイルの場合は、戻り値が正しくない可能性があります。 |
GetConnections() |
GetConnections は、作成されたすべての DkmTransportConnection オブジェクトを列挙します。 |
GetDataItem<T>() |
このコンテナー インスタンスに追加された 'T' のインスタンスを取得します。 このコンテナーに 'T' が含まれていない場合、この関数は null を返します。 (継承元 DkmDataContainer) |
GetDefaultClrVersion() |
監視プロセスに読み込まれる CLR のバージョンを返します。 |
GetDNSName() |
ターゲット コンピューターが使用する物理 DNS ホスト名を提供します。 |
GetFileListing(String, String, Boolean) |
ターゲット コンピューターに存在するファイルとサブディレクトリの一覧を取得します。 |
GetIsolatedStorageRootForApplication(DkmAppPackageId) |
指定したアプリケーションの分離ストレージ ルート ディレクトリへの完全なパスを取得します。 この API は Windows ストア アプリ用にまだ実装されていませんが、将来の使用のために予約されています。 |
GetLiveProcesses() |
GetLiveProcesses は、この DkmTransportConnection オブジェクトの DkmProcess 要素を列挙します。 すべてのオブジェクトに 'Live' パーツが含まれています。 |
GetProcesses() |
GetProcesses は、この DkmTransportConnection オブジェクトの DkmProcess 要素を列挙します。 |
GetProductionConnections() |
GetProductionConnections は、この DkmTransportConnection オブジェクトの DkmProductionConnection 要素を列挙します。 この API は、Visual Studio 15 Update 2 (DkmApiVersion.VS15Update2) で導入されました。 |
GetRecordedProcesses() |
GetRecordedProcesses は、この DkmTransportConnection オブジェクトの DkmRecordedProcessInfo 要素を列挙します。 この API は、Visual Studio 16 RTM (DkmApiVersion.VS16RTM) で導入されました。 |
GetRecordedProcessInfo(String) |
記録されたファイルに関する情報を取得します。 この API は、Visual Studio 16 RTM (DkmApiVersion.VS16RTM) で導入されました。 |
GetRequests() |
GetRequests は、この DkmTransportConnection オブジェクトの DkmProcessLaunchRequest 要素を列挙します。 |
GetRunningProcessInfo(Int32, Int64, Boolean, DkmRunningProcessInfoPropertyMask) |
ターゲット コンピューターで実行されているプロセスに関する情報を取得します。 |
GetSerializedProcessInfo(String) |
ファイルに関する情報を取得します。 この API は、Visual Studio 16 Update 8 (DkmApiVersion.VS16Update8) で導入されました。 |
GetSerializedProcessInformation() |
GetSerializedProcessInformation は、この DkmTransportConnection オブジェクトの DkmSerializedProcessInfo 要素を列挙します。 この API は、Visual Studio 16 Update 8 (DkmApiVersion.VS16Update8) で導入されました。 |
GetSystemInformation(Boolean) |
デバッグ モニターが実行されているコンピューターに関する情報を提供します。 |
QueryExecutableArchitecture(String) |
実行可能ファイルのアーキテクチャを取得します。 この API は、Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview) で導入されました。 |
QueryIsWOW64Executable(String) |
非推奨になりました。 QueryExecutableArchitecture を使用します。 64 ビット OS で 32 ビット プロセスを実行するために使用される WOW64 (Windows On Windows) 内で、指定された実行可能ファイルを実行するかどうかを決定します。 |
RemoveAppPackageFromTaskbar(DkmAppPackageId, UInt32) |
タスク バーを閉じて、イマーシブ アプリ アイコンを削除します。 この API は、Visual Studio 12 Update 3 (DkmApiVersion.VS12Update3) で導入されました。 |
RemoveDataItem<T>() |
このコンテナーから 'T' のインスタンスを削除します。 通常、オブジェクトが閉じられるとデータ コンテナーが自動的に空になるので、このメソッドを呼び出す必要があります。 (継承元 DkmDataContainer) |
RemoveDirectory(String, Boolean) |
ターゲット コンピューター上のディレクトリを削除します。 |
ResumeAppPackage(DkmAppPackageId, Int32) |
指定したアプリケーションに対して、シミュレートされたプロセス有効期間管理ベースの再開を実行します。 これは、開発者がアプリの再開ハンドラーをテストするために使用されます。 |
SetDataItem<T>(DkmDataCreationDisposition, T) |
データ コンテナーに新しい項目を配置します。 (継承元 DkmDataContainer) |
ShutDownAppPackage(DkmWorkList, DkmAppPackageId, Int32, DkmCompletionRoutine<DkmShutDownAppPackageAsyncResult>) |
プロセス有効期間管理サービスを使用して、指定したアプリケーションを中断してからシャットダウンします。 これを使用し、2 回目のアプリ起動を使用して、開発者はアプリの中断状態から再起動する機能をテストできます。 このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元は、完了ルーチンを通じて要求が完了したことを通知されます。 |
SuspendAppPackage(DkmWorkList, DkmAppPackageId, Int32, DkmCompletionRoutine<DkmSuspendAppPackageAsyncResult>) |
指定したアプリケーションに対して、シミュレートされたプロセス有効期間管理ベースの中断を実行します。 これは、開発者がアプリの中断ハンドラーをテストするために使用されます。 このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元は、完了ルーチンを通じて要求が完了したことを通知されます。 |
TakeNonDebugProcessSnapshot(UInt32) |
プロセスのプロセス スナップショットを受け取ります。 保持される唯一のデータはスナップショット自体であり、親プロセスへの参照はありません。 この API は、Visual Studio 17 Update 6 (DkmApiVersion.VS17Update6) で導入されました。 |
TerminateAppPackage(DkmWorkList, DkmAppPackageId, Int32, DkmCompletionRoutine<DkmTerminateAppPackageAsyncResult>) |
アプリ パッケージを終了します。 パッケージに関連付けられているすべてのプロセスが停止していることを確認するために使用されます。 このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元は、完了ルーチンを通じて要求が完了したことを通知されます。 この API は、Visual Studio 16 Update 9 (DkmApiVersion.VS16Update9) で導入されました。 |
TerminateRunningProcess(Int32, Int64, Int32) |
デバッグされていないターゲット コンピューターで実行されているプロセスを終了します。 |
TriggerPrefetch(String, DkmPackagedAppPlatform) |
アプリケーション コンテンツプリフェッチをトリガーします。 この API は、Visual Studio 12 Update 2 (DkmApiVersion.VS12Update2) で導入されました。 |