DkmStandardRemoteTransportConnection Класс

Определение

Представляет собой удаленное подключение между монитором и интегрированной среды разработки через стандартный транспорт. Этот класс является производным от 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
Наследование
DkmStandardRemoteTransportConnection
Наследование
DkmStandardRemoteTransportConnection
Атрибуты

Свойства

AuthenticationMode

Режим проверки подлинности, используемый при подключении через стандартное удаленное подключение.

DebuggerCpuArchitecture

Архитектура компонентов отладчика на стороне монитора. Это компоненты отладчика с уровнем < компонентов 100 000.

Этот API появился в Visual Studio 17 RTM (DkmApiVersion.VS17RTM).

(Унаследовано от DkmTransportConnection)
Flags

Флаги, указывающие признаки базового соединения.

(Унаследовано от DkmTransportConnection)
IsUnloaded

Возвращает значение true, если для этого объекта было инициировано событие "unloaded" (например, вызывается DkmThread::Unload) или если объект был закрыт. Обратите внимание, что при проверке этого состояния необходимо соблюдать осторожность, так как без синхронизации возвращаемое состояние может быть не точным после чтения инструкции.

(Унаследовано от DkmDataContainer)
Kind

Указывает тип транспорта, используемого для отладки.

(Унаследовано от DkmTransportConnection)
ProtocolVersion

Версия протокола, используемого между Visual Studio и целевым компьютером. Это минимальная версия протокола, понятная Visual Studio, и версия протокола, понятная удаленному отладчику.

Этот API появился в Visual Studio 11 с обновлением 1 (DkmApiVersion.VS11FeaturePack1).

(Унаследовано от DkmTransportConnection)
ProxyServer

[Необязательно] Прокси-сервер, используемый при подключении к этому компьютеру. Это значение равно NULL, если отладчик подключен непосредственно к компьютеру.

Qualifier

[Необязательно] Строка, указывающая назначение подключения. Это значение будет иметь значение NULL для локального подключения. Для удаленной отладки по умолчанию это имя компьютера и номер порта, к которым мы пытаемся подключиться.

(Унаследовано от DkmTransportConnection)
UniqueId

Guid, который однозначно идентифицирует это соединение. Локальное подключение будет использовать значение "DkmTransportKind.Local". Значение для других подключений будет создано случайным образом.

(Унаследовано от DkmTransportConnection)

Методы

Abort()

Автоматически прерывает транспортное подключение аналогично тому, что происходит при завершении работы Visual Studio или удаленного отладчика. Базовое подключение будет прервано, все выполняемые операции будут прерваны, а все отлаживаемые процессы будут прерваны.

Этот API появился в Visual Studio 11 с обновлением 2 (DkmApiVersion.VS11Update2).

ActivateAppPackage(DkmWorkList, DkmPackagedAppPlatform, String, Boolean, DkmCompletionRoutine<DkmActivateAppPackageAsyncResult>)

Активирует указанное упакованое приложение. Это приведет к запуску приложения, если оно еще не запущено, и возвратит его в качестве активного приложения, если оно уже запущено. При запуске в отладчике перед этим API будет вызываться IDkmProcessLaunchNotifyListener.StartListener.

Этот метод добавляет новый рабочий элемент в указанный список работ и возвращается после добавления рабочего элемента. Фактическая обработка рабочего элемента является асинхронной. Вызывающий объект получит уведомление о том, что запрос завершен с помощью процедуры завершения.

(Унаследовано от DkmTransportConnection)
ActivateAppPackageExtended(DkmWorkList, DkmPackagedAppPlatform, String, Boolean, DkmActivateAppPackageFlags, DkmCompletionRoutine<DkmActivateAppPackageAsyncResult>)

Активирует указанное упакованое приложение. Это приведет к запуску приложения, если оно еще не запущено, и возвратит его в качестве активного приложения, если оно уже запущено. При запуске в отладчике перед этим API будет вызываться IDkmProcessLaunchNotifyListener.StartListener.

Этот метод добавляет новый рабочий элемент в указанный список работ и возвращается после добавления рабочего элемента. Фактическая обработка рабочего элемента является асинхронной. Вызывающий объект получит уведомление о том, что запрос завершен с помощью процедуры завершения.

Этот API появился в Visual Studio 14 с обновлением 1 (DkmApiVersion.VS14Update1).

(Унаследовано от DkmTransportConnection)
ActivateAppPackageOnTargetMonitor(DkmWorkList, DkmPackagedAppPlatform, String, Boolean, UInt32, DkmCompletionRoutine<DkmActivateAppPackageAsyncResult>)

Активирует упакованое приложение на указанном мониторе. Это приведет к запуску приложения, если оно еще не запущено, и возвратит его в качестве активного приложения, если оно уже запущено.

Этот метод добавляет новый рабочий элемент в указанный список работ и возвращается после добавления рабочего элемента. Фактическая обработка рабочего элемента является асинхронной. Вызывающий объект получит уведомление о том, что запрос завершен с помощью процедуры завершения.

Этот API появился в Visual Studio 12 с обновлением 3 (DkmApiVersion.VS12Update3).

(Унаследовано от DkmTransportConnection)
ActivateAppPackageWithStartupTask(DkmWorkList, String, Boolean, DkmCompletionRoutine<DkmActivateAppPackageAsyncResult>)

Активирует указанное упакованое приложение. Это приведет к запуску приложения, если оно еще не запущено, и возвратит его в качестве активного приложения, если оно уже запущено. При запуске в отладчике перед этим API будет вызываться IDkmProcessLaunchNotifyListener.StartListener.

Этот метод добавляет новый рабочий элемент в указанный список работ и возвращается после добавления рабочего элемента. Фактическая обработка рабочего элемента является асинхронной. Вызывающий объект получит уведомление о том, что запрос завершен с помощью процедуры завершения.

Этот 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 с обновлением 8 (DkmApiVersion.VS16Update8).

(Унаследовано от DkmTransportConnection)
CreateDirectory(String)

Создает каталог на целевом компьютере. Обратите внимание, что каталоги создаются неявно при развертывании файлов. Поэтому этот API не требуется использовать в этом сценарии.

(Унаследовано от DkmTransportConnection)
DeleteFile(String)

Удаление файла на целевом компьютере.

(Унаследовано от DkmTransportConnection)
DeployFile(String, String, Boolean)

Разверните файл на целевом компьютере. Обратите внимание, что при этом будет скопировано содержимое файла и время последней записи, но не атрибуты.

Ограничение расположения: API должен вызываться из компонента интегрированной среды разработки (уровень > компонента 100 000).

(Унаследовано от DkmTransportConnection)
DownloadFile(DkmWorkList, String, String, Boolean, DkmCompletionRoutine<DkmDownloadFileAsyncResult>)

Скачайте файл с целевого компьютера. Обратите внимание, что при этом будет скопировано содержимое файла и время последней записи, но не атрибуты.

Этот метод добавляет новый рабочий элемент в указанный список работ и возвращается после добавления рабочего элемента. Фактическая обработка рабочего элемента является асинхронной. Вызывающий объект получит уведомление о том, что запрос завершен с помощью процедуры завершения.

Ограничение расположения: API должен вызываться из компонента интегрированной среды разработки (уровень > компонента 100 000).

(Унаследовано от DkmTransportConnection)
DownloadFile(String, String, Boolean)

Скачайте файл с целевого компьютера. Обратите внимание, что при этом будет скопировано содержимое файла и время последней записи, но не атрибуты.

Ограничение расположения: API должен вызываться из компонента интегрированной среды разработки (уровень > компонента 100 000).

(Унаследовано от DkmTransportConnection)
EnumerateBackgroundTasks(DkmWorkList, DkmAppPackageId, Int32, DkmCompletionRoutine<DkmEnumerateBackgroundTasksAsyncResult>)

Перечисляет существующие фоновые задачи. Он используется разработчиками для тестирования обработчика перечисления приложения.

Этот метод добавляет новый рабочий элемент в указанный список работ и возвращается после добавления рабочего элемента. Фактическая обработка рабочего элемента является асинхронной. Вызывающий объект получит уведомление о том, что запрос завершен с помощью процедуры завершения.

(Унаследовано от DkmTransportConnection)
EnumPackages()

Перечисляет установленные и запускаемые пакеты приложений (пакеты приложений с приложениями).

Ограничение расположения: API должен вызываться из компонента интегрированной среды разработки (уровень > компонента 100 000).

(Унаследовано от DkmTransportConnection)
EnumRunningProcesses(Boolean, DkmRunningProcessInfoPropertyMask)

Предоставляет список всех процессов, запущенных на целевом компьютере (включая процессы, которые не отлаживаются).

(Унаследовано от DkmTransportConnection)
EnumRunningProcesses(DkmWorkList, Boolean, DkmRunningProcessInfoPropertyMask, DkmCompletionRoutine<DkmEnumRunningProcessesAsyncResult>)

Предоставляет список всех процессов, запущенных на целевом компьютере (включая процессы, которые не отлаживаются).

Этот метод добавляет новый рабочий элемент в указанный список работ и возвращается после добавления рабочего элемента. Фактическая обработка рабочего элемента является асинхронной. Вызывающий объект получит уведомление о том, что запрос завершен с помощью процедуры завершения.

(Унаследовано от DkmTransportConnection)
FindLiveProcess(Int32)

Найдите элемент DkmProcess в этом DkmTransportConnection. Если нет элемента с заданным входным ключом, FindLiveProcess завершится ошибкой. Если объект найден, он всегда будет содержать динамическую часть.

(Унаследовано от DkmTransportConnection)
FindProcess(Guid)

Найдите элемент DkmProcess в этом DkmTransportConnection. Если нет элемента с заданным входным ключом, findProcess завершится ошибкой.

(Унаследовано от DkmTransportConnection)
FindProductionConnection(Guid)

Найдите элемент DkmProductionConnection в этом DkmTransportConnection. Если нет элемента с заданным входным ключом, FindProductionConnection завершится ошибкой.

Этот API появился в Visual Studio 15 с обновлением 2 (DkmApiVersion.VS15Update2).

(Унаследовано от DkmTransportConnection)
FindRecordedProcessInfo(String)

Найдите элемент DkmRecordedProcessInfo в этом DkmTransportConnection. Если нет элемента с заданным входным ключом, findRecordedProcessInfo завершится ошибкой.

Этот API появился в Visual Studio 16 RTM (DkmApiVersion.VS16RTM).

(Унаследовано от DkmTransportConnection)
FindSerializedProcessInfo(String)

Найдите элемент DkmSerializedProcessInfo в этом DkmTransportConnection. Если нет элемента с заданным входным ключом, FindSerializedProcessInfo завершится ошибкой.

Этот API появился в Visual Studio 16 с обновлением 8 (DkmApiVersion.VS16Update8).

(Унаследовано от DkmTransportConnection)
FlushClosedObjectQueue()

Эта функция используется для немедленного обмена всеми уведомлениями о закрытии объектов с процессом мониторинга. Как 'GC. Сбор данных в управляемом коде эта функция обычно не нужна, так как система автоматически очищает очередь. Однако этот метод можно использовать, если важно, чтобы все обновления были немедленно заменены.

Уведомление о закрытии объекта создается (и помещается в очередь), когда компонент вызывает "Закрыть" для заданного объекта. Процесс мониторинга и процесс обработчика поддерживают очередь закрытых объектов. Этот метод можно вызывать только из процесса подсистемы, но он используется для очистки обеих очередей.

Ограничение расположения: API должен вызываться из компонента IDE (уровень > компонента 100 000).

(Унаследовано от DkmTransportConnection)
GetAppPackageExecutionState(DkmAppPackageId, Int32)

Получение состояния выполнения приложения Магазина Windows. Значения в этом поле указываются в PACKAGE_EXECUTION_STATE.

(Унаследовано от DkmTransportConnection)
GetClrVersionOfExecutable(String)

Предоставляет строку версии для среды CLR, которую отладчик ожидает для загрузки заданного исполняемого файла. Возвращаемое значение основано на содержимом заголовка PE исполняемого файла (если exe управляется), файла конфигурации исполняемого файла, переменных среды CLR и политики загрузчика в реестре. Возвращаемое значение может быть неправильным, особенно в случае собственного исполняемого файла.

(Унаследовано от 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 перечисляет элементы DkmProcess этого объекта DkmTransportConnection. Все объекты содержат динамическую часть.

(Унаследовано от DkmTransportConnection)
GetProcesses()

GetProcesses перечисляет элементы DkmProcess этого объекта DkmTransportConnection.

(Унаследовано от DkmTransportConnection)
GetProductionConnections()

GetProductionConnections перечисляет элементы DkmProductionConnection этого объекта DkmTransportConnection.

Этот API появился в Visual Studio 15 с обновлением 2 (DkmApiVersion.VS15Update2).

(Унаследовано от DkmTransportConnection)
GetRecordedProcesses()

GetRecordedProcesses перечисляет элементы DkmRecordedProcessInfo этого объекта DkmTransportConnection.

Этот API появился в Visual Studio 16 RTM (DkmApiVersion.VS16RTM).

(Унаследовано от DkmTransportConnection)
GetRecordedProcessInfo(String)

Получение сведений о записанном файле.

Этот API появился в Visual Studio 16 RTM (DkmApiVersion.VS16RTM).

(Унаследовано от DkmTransportConnection)
GetRequests()

GetRequests перечисляет элементы DkmProcessLaunchRequest этого объекта DkmTransportConnection.

(Унаследовано от DkmTransportConnection)
GetRunningProcessInfo(Int32, Int64, Boolean, DkmRunningProcessInfoPropertyMask)

Получение сведений о процессе, выполняемом на целевом компьютере.

(Унаследовано от DkmTransportConnection)
GetSerializedProcessInfo(String)

Получение сведений о файле.

Этот API появился в Visual Studio 16 с обновлением 8 (DkmApiVersion.VS16Update8).

(Унаследовано от DkmTransportConnection)
GetSerializedProcessInformation()

GetSerializedProcessInformation перечисляет элементы DkmSerializedProcessInfo этого объекта DkmTransportConnection.

Этот API появился в Visual Studio 16 с обновлением 8 (DkmApiVersion.VS16Update8).

(Унаследовано от DkmTransportConnection)
GetSystemInformation(Boolean)

Предоставляет сведения о компьютере, на котором выполняется отладочный монитор.

(Унаследовано от DkmTransportConnection)
QueryExecutableArchitecture(String)

Возвращает архитектуру исполняемого файла.

Этот API появился в Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview).

(Унаследовано от DkmTransportConnection)
QueryIsWOW64Executable(String)

Не рекомендуется. Используйте QueryExecutableArchitecture. Определяет, будет ли данный исполняемый файл выполняться в WOW64 (Windows On Windows), который используется для выполнения 32-разрядных процессов в 64-разрядной ОС.

(Унаследовано от DkmTransportConnection)
RemoveAppPackageFromTaskbar(DkmAppPackageId, UInt32)

Удаляет значок иммерсивного приложения с панели задач, закрывая его.

Этот API появился в Visual Studio 12 с обновлением 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)

Принимает процесс snapshot процесса. Единственными сохраненными данными является сам snapshot, нет ссылки на какой-либо родительский процесс.

Этот API появился в Visual Studio 17 с обновлением 6 (DkmApiVersion.VS17Update6).

(Унаследовано от DkmTransportConnection)
TerminateAppPackage(DkmWorkList, DkmAppPackageId, Int32, DkmCompletionRoutine<DkmTerminateAppPackageAsyncResult>)

Завершение пакета приложения. Используется для остановки всех процессов, связанных с пакетом.

Этот метод добавляет новый рабочий элемент в указанный рабочий список и возвращается после добавления рабочего элемента. Фактическая обработка рабочего элемента является асинхронной. Вызывающий объект получит уведомление о том, что запрос завершен в рамках процедуры завершения.

Этот API появился в Visual Studio 16 с обновлением 9 (DkmApiVersion.VS16Update9).

(Унаследовано от DkmTransportConnection)
TerminateRunningProcess(Int32, Int64, Int32)

Завершает процесс, запущенный на целевом компьютере, который не выполняет отладку.

(Унаследовано от DkmTransportConnection)
TriggerPrefetch(String, DkmPackagedAppPlatform)

Активирует предварительную выборку содержимого приложения.

Этот API появился в Visual Studio 12 с обновлением 2 (DkmApiVersion.VS12Update2).

(Унаследовано от DkmTransportConnection)

Применяется к