DkmStandardRemoteTransportConnection 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
这表示监视器与 IDE 之间通过标准传输进行远程连接。 此类派生自 DkmTransportConnection,并定义用于连接到目标计算机的选项。
public ref class DkmStandardRemoteTransportConnection : Microsoft::VisualStudio::Debugger::DefaultPort::DkmTransportConnection
[System.Runtime.InteropServices.Guid("97a0464d-a80e-ab40-233b-e55b49e3dfd9")]
public class DkmStandardRemoteTransportConnection : Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection
[<System.Runtime.InteropServices.Guid("97a0464d-a80e-ab40-233b-e55b49e3dfd9")>]
type DkmStandardRemoteTransportConnection = class
inherit DkmTransportConnection
Public Class DkmStandardRemoteTransportConnection
Inherits DkmTransportConnection
- 继承
- 继承
- 属性
属性
AuthenticationMode |
通过标准远程连接进行连接时要使用的身份验证模式。 |
DebuggerCpuArchitecture |
监视器端调试器组件的体系结构。 这是组件级别 < 为 100,000 的调试器组件。 此 API 是在 Visual Studio 17 RTM (DkmApiVersion.VS17RTM) 中引入的。 (继承自 DkmTransportConnection) |
Flags |
指示基础连接特征的标志。 (继承自 DkmTransportConnection) |
IsUnloaded |
如果已为此对象引发“unloaded”事件,则返回 true (示例:DkmThread::Unload) 或对象已关闭。 请注意,检查此状态时必须小心,因为如果不进行同步,则返回的状态在读取指令后可能不再准确。 (继承自 DkmDataContainer) |
Kind |
指示用于调试的传输类型。 (继承自 DkmTransportConnection) |
ProtocolVersion |
Visual Studio 与目标计算机之间使用的协议版本。 这是 Visual Studio 了解的最低协议版本,也是远程调试器所理解的协议版本。 此 API 是在 Visual Studio 11 Update 1 (DkmApiVersion.VS11FeaturePack1) 中引入的。 (继承自 DkmTransportConnection) |
ProxyServer |
[可选]连接到此计算机时使用的代理服务器。 如果调试器直接连接到计算机,则为 null。 |
Qualifier |
[可选]指示连接目标的字符串。 对于本地连接,这将为 null。 对于默认远程调试,这是我们尝试连接到的计算机名称和端口号。 (继承自 DkmTransportConnection) |
UniqueId |
唯一标识此连接的 Guid。 本地连接将使用值“DkmTransportKind.Local”。 将随机生成其他连接的值。 (继承自 DkmTransportConnection) |
方法
Abort() |
以类似于 Visual Studio 或远程调试器终止时发生的情况,以无提示方式中止传输连接。 基础连接将被删除,任何正在进行的操作都将中止,并且当前任何调试的进程都将终止。 此 API 是在 Visual Studio 11 Update 2 (DkmApiVersion.VS11Update2) 中引入的。 |
ActivateAppPackage(DkmWorkList, DkmPackagedAppPlatform, String, Boolean, DkmCompletionRoutine<DkmActivateAppPackageAsyncResult>) |
激活指定的打包应用程序。 如果应用程序尚未启动,这将导致应用程序启动;如果应用程序已在运行,则会将其恢复为活动应用程序。 在调试器下启动时,IDkmProcessLaunchNotifyListener.StartListener 将在此 API 之前调用。 此方法会将新工作项追加到指定的工作列表,并在追加工作项后返回 。 工作项的实际处理是异步的。 将通过完成例程通知调用方请求已完成。 (继承自 DkmTransportConnection) |
ActivateAppPackageExtended(DkmWorkList, DkmPackagedAppPlatform, String, Boolean, DkmActivateAppPackageFlags, DkmCompletionRoutine<DkmActivateAppPackageAsyncResult>) |
激活指定的打包应用程序。 如果应用程序尚未启动,这将导致应用程序启动;如果应用程序已在运行,则会将其恢复为活动应用程序。 在调试器下启动时,IDkmProcessLaunchNotifyListener.StartListener 将在此 API 之前调用。 此方法会将新工作项追加到指定的工作列表,并在追加工作项后返回 。 工作项的实际处理是异步的。 将通过完成例程通知调用方请求已完成。 此 API 是在 Visual Studio 14 Update 1 (DkmApiVersion.VS14Update1) 中引入的。 (继承自 DkmTransportConnection) |
ActivateAppPackageOnTargetMonitor(DkmWorkList, DkmPackagedAppPlatform, String, Boolean, UInt32, DkmCompletionRoutine<DkmActivateAppPackageAsyncResult>) |
在指定的监视器上激活打包的应用程序。 如果应用程序尚未启动,这将导致应用程序启动;如果应用程序已在运行,则会将其恢复为活动应用程序。 此方法会将新工作项追加到指定的工作列表,并在追加工作项后返回 。 工作项的实际处理是异步的。 将通过完成例程通知调用方请求已完成。 此 API 是在 Visual Studio 12 Update 3 (DkmApiVersion.VS12Update3) 中引入的。 (继承自 DkmTransportConnection) |
ActivateAppPackageWithStartupTask(DkmWorkList, String, Boolean, DkmCompletionRoutine<DkmActivateAppPackageAsyncResult>) |
激活指定的打包应用程序。 如果应用程序尚未启动,这将导致应用程序启动;如果应用程序已在运行,则会将其恢复为活动应用程序。 在调试器下启动时,IDkmProcessLaunchNotifyListener.StartListener 将在此 API 之前调用。 此方法会将新工作项追加到指定的工作列表,并在追加工作项后返回 。 工作项的实际处理是异步的。 将通过完成例程通知调用方请求已完成。 此 API 是在 Visual Studio 14 RTM (DkmApiVersion.VS14RTM) 中引入的。 (继承自 DkmTransportConnection) |
ActivateBackgroundTask(DkmWorkList, DkmAppPackageId, Int32, Guid, DkmCompletionRoutine<DkmActivateBackgroundTaskAsyncResult>) |
激活后台任务。 开发人员使用此函数来测试其应用的激活处理程序。 此方法会将新工作项追加到指定的工作列表,并在追加工作项后返回 。 工作项的实际处理是异步的。 将通过完成例程通知调用方请求已完成。 (继承自 DkmTransportConnection) |
CreateCoreDumpParserTargetCompositionServices(String, Object) |
Create用于核心文件分析方案的 IDebugServiceManager 实例,可用于访问基于目标组合的扩展。 DkmProcess 可用后,调用 SetCoreDumpParserTargetCompositionServices,以便可以正确缓存实例。 位置约束:目标组合接口不能跨计算机封送,但可以安全地使用(如果可用)。 此 API 是在 Visual Studio 16 Update 8 (DkmApiVersion.VS16Update8) 中引入的。 (继承自 DkmTransportConnection) |
CreateDirectory(String) |
在目标计算机上创建目录。 请注意,部署文件时会隐式创建目录。 因此,无需在此方案中使用此 API。 (继承自 DkmTransportConnection) |
DeleteFile(String) |
删除目标计算机上的文件。 (继承自 DkmTransportConnection) |
DeployFile(String, String, Boolean) |
将文件部署到目标计算机。 请注意,这会复制文件内容和上次写入时间,但不会复制属性。 位置约束:必须从 IDE 组件 (组件级别 > 100,000) 调用 API。 (继承自 DkmTransportConnection) |
DownloadFile(DkmWorkList, String, String, Boolean, DkmCompletionRoutine<DkmDownloadFileAsyncResult>) |
从目标计算机下载文件。 请注意,这会复制文件内容和上次写入时间,但不会复制属性。 此方法会将新工作项追加到指定的工作列表,并在追加工作项后返回 。 工作项的实际处理是异步的。 将通过完成例程通知调用方请求已完成。 位置约束:必须从 IDE 组件 (组件级别 > 100,000) 调用 API。 (继承自 DkmTransportConnection) |
DownloadFile(String, String, Boolean) |
从目标计算机下载文件。 请注意,这会复制文件内容和上次写入时间,但不会复制属性。 位置约束:必须从 IDE 组件 (组件级别 > 100,000) 调用 API。 (继承自 DkmTransportConnection) |
EnumerateBackgroundTasks(DkmWorkList, DkmAppPackageId, Int32, DkmCompletionRoutine<DkmEnumerateBackgroundTasksAsyncResult>) |
枚举现有后台任务。 开发人员使用此函数来测试其应用的枚举处理程序。 此方法会将新工作项追加到指定的工作列表,并在追加工作项后返回 。 工作项的实际处理是异步的。 将通过完成例程通知调用方请求已完成。 (继承自 DkmTransportConnection) |
EnumPackages() |
枚举已安装和可启动 (应用程序包的应用程序) 应用程序包。 位置约束:必须从 IDE 组件 (组件级别 > 100,000) 调用 API。 (继承自 DkmTransportConnection) |
EnumRunningProcesses(Boolean, DkmRunningProcessInfoPropertyMask) |
提供目标计算机上运行的所有进程的列表 (包括未) 调试的进程。 (继承自 DkmTransportConnection) |
EnumRunningProcesses(DkmWorkList, Boolean, DkmRunningProcessInfoPropertyMask, DkmCompletionRoutine<DkmEnumRunningProcessesAsyncResult>) |
提供目标计算机上运行的所有进程的列表 (包括未) 调试的进程。 此方法会将新工作项追加到指定的工作列表,并在追加工作项后返回 。 工作项的实际处理是异步的。 将通过完成例程通知调用方请求已完成。 (继承自 DkmTransportConnection) |
FindLiveProcess(Int32) |
在此 DkmTransportConnection 中查找 DkmProcess 元素。 如果不存在具有给定输入键的元素,FindLiveProcess 将失败。 如果找到对象,它将始终包含“Live”部件。 (继承自 DkmTransportConnection) |
FindProcess(Guid) |
在此 DkmTransportConnection 中查找 DkmProcess 元素。 如果不存在具有给定输入键的元素,FindProcess 将失败。 (继承自 DkmTransportConnection) |
FindProductionConnection(Guid) |
在此 DkmTransportConnection 中查找 DkmProductionConnection 元素。 如果不存在具有给定输入键的元素,FindProductionConnection 将失败。 此 API 是在 Visual Studio 15 Update 2 (DkmApiVersion.VS15Update2) 中引入的。 (继承自 DkmTransportConnection) |
FindRecordedProcessInfo(String) |
在此 DkmTransportConnection 中查找 DkmRecordedProcessInfo 元素。 如果不存在具有给定输入键的元素,FindRecordedProcessInfo 将失败。 此 API 是在 Visual Studio 16 RTM (DkmApiVersion.VS16RTM) 中引入的。 (继承自 DkmTransportConnection) |
FindSerializedProcessInfo(String) |
在此 DkmTransportConnection 中查找 DkmSerializedProcessInfo 元素。 如果不存在具有给定输入键的元素,FindSerializedProcessInfo 将失败。 此 API 是在 Visual Studio 16 Update 8 (DkmApiVersion.VS16Update8) 中引入的。 (继承自 DkmTransportConnection) |
FlushClosedObjectQueue() |
此函数用于强制所有对象关闭通知立即与监视进程交换。 像 'GC。在托管代码中收集',此函数通常是不必要的,因为系统会自动刷新队列。 但是,如果必须立即交换所有更新,则可以使用此方法。 当组件对给定对象调用“Close”时,会 (创建对象关闭通知,并在) 排队。 监视进程和引擎进程都维护一个已关闭对象的队列。 此方法只能从引擎进程调用,但它用于刷新两个队列。 位置约束:必须从 IDE 组件 (组件级别 > 100,000) 调用 API。 (继承自 DkmTransportConnection) |
GetAppPackageExecutionState(DkmAppPackageId, Int32) |
获取 Windows 应用商店应用的执行状态。 此字段中的值在 PACKAGE_EXECUTION_STATE 中指定。 (继承自 DkmTransportConnection) |
GetClrVersionOfExecutable(String) |
为调试器需要加载给定可执行文件的 CLR 提供版本字符串。 如果可执行文件) 、可执行文件的配置文件、CLR 环境变量和注册表中的加载程序策略,则返回值基于可执行文件的 PE 标头的内容 (。 返回值可能不正确,尤其是在本机可执行文件的情况下。 (继承自 DkmTransportConnection) |
GetDataItem<T>() |
获取已添加到此容器实例的“T”实例。 如果此容器不包含“T”,则此函数将返回 null。 (继承自 DkmDataContainer) |
GetDefaultClrVersion() |
返回在监视进程中加载的 CLR 版本。 (继承自 DkmTransportConnection) |
GetDNSName() |
提供目标计算机使用的物理 DNS 主机名。 (继承自 DkmTransportConnection) |
GetFileListing(String, String, Boolean) |
获取目标计算机上存在的文件和子目录的列表。 (继承自 DkmTransportConnection) |
GetIsolatedStorageRootForApplication(DkmAppPackageId) |
获取指定应用程序的独立存储根目录的完整路径。 此 API 尚未为 Windows 应用商店应用实现,但保留供将来使用。 (继承自 DkmTransportConnection) |
GetLiveProcesses() |
GetLiveProcesses 枚举此 DkmTransportConnectionobject 的 DkmProcess 元素。 所有对象都包含“Live”部件。 (继承自 DkmTransportConnection) |
GetProcesses() |
GetProcesses 枚举此 DkmTransportConnection 对象的 DkmProcess 元素。 (继承自 DkmTransportConnection) |
GetProductionConnections() |
GetProductionConnections 枚举此 DkmTransportConnection 对象的 DkmProductionConnection 元素。 此 API 是在 Visual Studio 15 Update 2 (DkmApiVersion.VS15Update2) 中引入的。 (继承自 DkmTransportConnection) |
GetRecordedProcesses() |
GetRecordedProcesses 枚举此 DkmTransportConnection 对象的 DkmRecordedProcessInfo 元素。 此 API 是在 Visual Studio 16 RTM (DkmApiVersion.VS16RTM) 中引入的。 (继承自 DkmTransportConnection) |
GetRecordedProcessInfo(String) |
获取有关记录的文件的信息。 此 API 是在 Visual Studio 16 RTM (DkmApiVersion.VS16RTM) 中引入的。 (继承自 DkmTransportConnection) |
GetRequests() |
GetRequests 枚举此 DkmTransportConnection 对象的 DkmProcessLaunchRequest 元素。 (继承自 DkmTransportConnection) |
GetRunningProcessInfo(Int32, Int64, Boolean, DkmRunningProcessInfoPropertyMask) |
获取有关目标计算机上运行的进程的信息。 (继承自 DkmTransportConnection) |
GetSerializedProcessInfo(String) |
获取有关文件的信息。 此 API 是在 Visual Studio 16 Update 8 (DkmApiVersion.VS16Update8) 中引入的。 (继承自 DkmTransportConnection) |
GetSerializedProcessInformation() |
GetSerializedProcessInformation 枚举此 DkmTransportConnection 对象的 DkmSerializedProcessInfo 元素。 此 API 是在 Visual Studio 16 Update 8 (DkmApiVersion.VS16Update8) 中引入的。 (继承自 DkmTransportConnection) |
GetSystemInformation(Boolean) |
提供有关运行调试监视器的计算机的信息。 (继承自 DkmTransportConnection) |
QueryExecutableArchitecture(String) |
获取可执行文件的体系结构。 此 API 是在 Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview) 中引入的。 (继承自 DkmTransportConnection) |
QueryIsWOW64Executable(String) |
已弃用。 使用 QueryExecutableArchitecture。 确定给定的可执行文件是否将在 WOW64 (Windows On Windows) 中执行,后者用于在 64 位 OS 上执行 32 位进程。 (继承自 DkmTransportConnection) |
RemoveAppPackageFromTaskbar(DkmAppPackageId, UInt32) |
通过关闭任务栏删除沉浸式应用图标。 此 API 是在 Visual Studio 12 Update 3 (DkmApiVersion.VS12Update3) 中引入的。 (继承自 DkmTransportConnection) |
RemoveDataItem<T>() |
从此容器中删除“T”的实例。 通常不需要调用此方法,因为数据容器将在对象关闭时自动清空。 (继承自 DkmDataContainer) |
RemoveDirectory(String, Boolean) |
删除目标计算机上的目录。 (继承自 DkmTransportConnection) |
ResumeAppPackage(DkmAppPackageId, Int32) |
对指定的应用程序执行基于模拟进程生存期管理的恢复。 开发人员使用此函数来测试其应用的恢复处理程序。 (继承自 DkmTransportConnection) |
SetDataItem<T>(DkmDataCreationDisposition, T) |
将新项放在数据容器中。 (继承自 DkmDataContainer) |
ShutDownAppPackage(DkmWorkList, DkmAppPackageId, Int32, DkmCompletionRoutine<DkmShutDownAppPackageAsyncResult>) |
使用进程生存期管理服务暂停并关闭指定的应用程序。 使用此功能,然后启动第二个应用,开发人员可以测试其应用从暂停状态重启的能力。 此方法会将新工作项追加到指定的工作列表,并在追加工作项后返回 。 工作项的实际处理是异步的。 将通过完成例程通知调用方请求已完成。 (继承自 DkmTransportConnection) |
SuspendAppPackage(DkmWorkList, DkmAppPackageId, Int32, DkmCompletionRoutine<DkmSuspendAppPackageAsyncResult>) |
对指定的应用程序执行基于模拟进程生存期管理的挂起。 开发人员使用此函数来测试其应用的挂起处理程序。 此方法会将新工作项追加到指定的工作列表,并在追加工作项后返回 。 工作项的实际处理是异步的。 将通过完成例程通知调用方请求已完成。 (继承自 DkmTransportConnection) |
TakeNonDebugProcessSnapshot(UInt32) |
将进程快照。 唯一保留的数据是快照本身,没有任何引用回任何父进程。 此 API 是在 Visual Studio 17 Update 6 (DkmApiVersion.VS17Update6) 中引入的。 (继承自 DkmTransportConnection) |
TerminateAppPackage(DkmWorkList, DkmAppPackageId, Int32, DkmCompletionRoutine<DkmTerminateAppPackageAsyncResult>) |
终止应用包。 用于确保与包关联的所有进程都已停止。 此方法会将新工作项追加到指定的工作列表,并在追加工作项后返回 。 工作项的实际处理是异步的。 将通过完成例程通知调用方请求已完成。 此 API 是在 Visual Studio 16 Update 9 (DkmApiVersion.VS16Update9) 中引入的。 (继承自 DkmTransportConnection) |
TerminateRunningProcess(Int32, Int64, Int32) |
终止未调试的目标计算机上运行的进程。 (继承自 DkmTransportConnection) |
TriggerPrefetch(String, DkmPackagedAppPlatform) |
触发应用程序内容预提取。 此 API 是在 Visual Studio 12 Update 2 (DkmApiVersion.VS12Update2) 中引入的。 (继承自 DkmTransportConnection) |