DkmTransportConnection Třída

Definice

Obor názvů:

Microsoft.VisualStudio.Debugger.DefaultPort

Sestavení:

Microsoft.VisualStudio.Debugger.Engine.dll

Balíček:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

To představuje připojení mezi monitorováním a integrovaným vývojovém prostředím. Může se jednat o místní připojení, pokud monitorování běží ve stejném procesu jako integrované vývojové prostředí (IDE), nebo může být vzdálené připojení. V procesu monitorování existuje pouze jedno připojení.

Odvozené třídy: 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

Dědičnost

Object

DkmDataContainer

DkmTransportConnection

Odvozené

Microsoft.VisualStudio.Debugger.DefaultPort.DkmStandardRemoteTransportConnection

Atributy

GuidAttribute

Vlastnosti

DebuggerCpuArchitecture	Architektura komponent ladicího programu na straně monitoru To jsou komponenty ladicího programu s úrovní < komponent 100 000. Toto rozhraní API bylo zavedeno v sadě Visual Studio 17 RTM (DkmApiVersion.VS17RTM).
Flags	Příznaky označující vlastnosti základního připojení.
IsUnloaded	Vrátí hodnotu true, pokud byla pro tento objekt vyvolána událost unloaded (příklad: DkmThread::Unload je volána) nebo pokud byl objekt uzavřen. Mějte na paměti, že při kontrole tohoto stavu je potřeba střídmět, protože bez synchronizace nemusí být vrácený stav po přečtení přesný. (Zděděno od DkmDataContainer)
Kind	Určuje typ přenosu, který se používá k ladění.
ProtocolVersion	Verze protokolu použitého mezi sadou Visual Studio a cílovým počítačem. Toto je minimum verze protokolu, které visual Studio rozumí, a verze protokolu, které vzdálený ladicí program rozumí. Toto rozhraní API bylo představeno v sadě Visual Studio 11 Update 1 (DkmApiVersion.VS11FeaturePack1).
Qualifier	[Volitelné] Řetězec označující cíl připojení. Pro místní připojení bude mít hodnotu null. U výchozího vzdáleného ladění je to název počítače a číslo portu, ke kterému se pokoušíme připojit.
UniqueId	Identifikátor GUID, který jednoznačně identifikuje toto připojení. Místní připojení použije hodnotu DkmTransportKind.Local. Hodnota pro jiná připojení se vygeneruje náhodně.

Metody

ActivateAppPackage(DkmWorkList, DkmPackagedAppPlatform, String, Boolean, DkmCompletionRoutine<DkmActivateAppPackageAsyncResult>)	Aktivuje zadanou zabalenou aplikaci. To způsobí, že se aplikace spustí, pokud se ještě nespustila, a vrátí ji zpět jako aktivní aplikaci, pokud už je spuštěná. Při spuštění v ladicím programu se před tímto rozhraním API zavolá IDkmProcessLaunchNotifyListener.StartListener. Tato metoda přidá novou pracovní položku do zadaného pracovního seznamu a vrátí po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající bude upozorněn, že žádost je dokončena prostřednictvím rutiny dokončení.
ActivateAppPackageExtended(DkmWorkList, DkmPackagedAppPlatform, String, Boolean, DkmActivateAppPackageFlags, DkmCompletionRoutine<DkmActivateAppPackageAsyncResult>)	Aktivuje zadanou zabalenou aplikaci. To způsobí, že se aplikace spustí, pokud se ještě nespustila, a vrátí ji zpět jako aktivní aplikaci, pokud už je spuštěná. Při spuštění v ladicím programu se před tímto rozhraním API zavolá IDkmProcessLaunchNotifyListener.StartListener. Tato metoda přidá novou pracovní položku do zadaného pracovního seznamu a vrátí po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající bude upozorněn, že žádost je dokončena prostřednictvím rutiny dokončení. Toto rozhraní API bylo zavedeno v sadě Visual Studio 14 Update 1 (DkmApiVersion.VS14Update1).
ActivateAppPackageOnTargetMonitor(DkmWorkList, DkmPackagedAppPlatform, String, Boolean, UInt32, DkmCompletionRoutine<DkmActivateAppPackageAsyncResult>)	Aktivuje zabalenou aplikaci na zadaném monitoru. To způsobí, že se aplikace spustí, pokud se ještě nespustila, a vrátí ji zpět jako aktivní aplikaci, pokud už je spuštěná. Tato metoda přidá novou pracovní položku do zadaného pracovního seznamu a vrátí po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající bude upozorněn, že žádost je dokončena prostřednictvím rutiny dokončení. Toto rozhraní API bylo zavedeno v sadě Visual Studio 12 Update 3 (DkmApiVersion.VS12Update3).
ActivateAppPackageWithStartupTask(DkmWorkList, String, Boolean, DkmCompletionRoutine<DkmActivateAppPackageAsyncResult>)	Aktivuje zadanou zabalenou aplikaci. To způsobí, že se aplikace spustí, pokud se ještě nespustila, a vrátí ji zpět jako aktivní aplikaci, pokud už je spuštěná. Při spuštění v ladicím programu se před tímto rozhraním API zavolá IDkmProcessLaunchNotifyListener.StartListener. Tato metoda přidá novou pracovní položku do zadaného pracovního seznamu a vrátí po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající bude upozorněn, že žádost je dokončena prostřednictvím rutiny dokončení. Toto rozhraní API bylo zavedeno v sadě Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
ActivateBackgroundTask(DkmWorkList, DkmAppPackageId, Int32, Guid, DkmCompletionRoutine<DkmActivateBackgroundTaskAsyncResult>)	Aktivace úlohy na pozadí Tuto rutinu používají vývojáři k testování obslužné rutiny aktivace aplikace. Tato metoda přidá novou pracovní položku do zadaného pracovního seznamu a vrátí po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající bude upozorněn, že žádost je dokončena prostřednictvím rutiny dokončení.
CreateCoreDumpParserTargetCompositionServices(String, Object)	Create instanci IDebugServiceManager pro scénář analýzy souborů Core, který lze použít pro přístup k rozšířením založeným na cílové složce. Jakmile je DkmProcess k dispozici, zavolejte SetCoreDumpParserTargetCompositionServices, aby bylo možné instanci správně uložit do mezipaměti. Omezení umístění: Rozhraní cílového složení nelze seskuřovat napříč počítačem, ale je možné je bezpečně použít, pokud je k dispozici. Toto rozhraní API bylo zavedeno v sadě Visual Studio 16 Update 8 (DkmApiVersion.VS16Update8).
CreateDirectory(String)	Vytvoří adresář v cílovém počítači. Všimněte si, že adresáře se při nasazování souborů vytvářejí implicitně. Toto rozhraní API se tedy v tomto scénáři nemusí používat.
DeleteFile(String)	Odstraňte soubor v cílovém počítači.
DeployFile(String, String, Boolean)	Nasaďte soubor do cílového počítače. Všimněte si, že se tím zkopíruje obsah souboru a čas posledního zápisu, ale ne atributy. Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).
DownloadFile(DkmWorkList, String, String, Boolean, DkmCompletionRoutine<DkmDownloadFileAsyncResult>)	Stáhněte soubor z cílového počítače. Všimněte si, že se tím zkopíruje obsah souboru a čas posledního zápisu, ale ne atributy. Tato metoda přidá novou pracovní položku do zadaného pracovního seznamu a vrátí po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající bude upozorněn, že žádost je dokončena prostřednictvím rutiny dokončení. Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).
DownloadFile(String, String, Boolean)	Stáhněte soubor z cílového počítače. Všimněte si, že se tím zkopíruje obsah souboru a čas posledního zápisu, ale ne atributy. Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).
EnumerateBackgroundTasks(DkmWorkList, DkmAppPackageId, Int32, DkmCompletionRoutine<DkmEnumerateBackgroundTasksAsyncResult>)	Vytvoří výčet existujících úloh na pozadí. Používají ho vývojáři k testování obslužné rutiny výčtu své aplikace. Tato metoda přidá novou pracovní položku do zadaného pracovního seznamu a vrátí po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající bude upozorněn, že žádost je dokončena prostřednictvím rutiny dokončení.
EnumPackages()	Vytvoří výčet nainstalovaných a spouštěcích balíčků aplikací (balíčky aplikací s aplikacemi). Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).
EnumRunningProcesses(Boolean, DkmRunningProcessInfoPropertyMask)	Poskytuje seznam všech procesů spuštěných na cílovém počítači (včetně procesů, které nejsou laděné).
EnumRunningProcesses(DkmWorkList, Boolean, DkmRunningProcessInfoPropertyMask, DkmCompletionRoutine<DkmEnumRunningProcessesAsyncResult>)	Poskytuje seznam všech procesů spuštěných na cílovém počítači (včetně procesů, které nejsou laděné). Tato metoda přidá novou pracovní položku do zadaného pracovního seznamu a vrátí po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající bude upozorněn, že žádost je dokončena prostřednictvím rutiny dokončení.
ExtractFromDeployConnection(IVsDebuggerDeployConnection)	Získá objekt DkmTransportConnection, který zálohuje připojení nasazení. Dá se použít k přemětu rozhraní API pro nasazení ladicího programu na rozhraní API ladicího programu (Dkm). Můžete ho například použít k odesílání DkmCustomMessages. Volající musí stále držet na deployConnection, aby se zabránilo odstranění podkladového DkmTransportConnection. Všimněte si, že při zastavení ladění se ve výchozím nastavení uvolní komponenty concordu. Toto chování lze přepsat nastavením 'StayLoadedForDeployConnection="true"' v souboru komponenty .vsdconfigxml. To je užitečné, pokud volající chce extrahovat připojení nasazení, aby mohl odesílat vlastní zprávy, a chce to udělat po ukončení relace ladicího programu.
ExtractFromPort(IDebugPort2)	Získá objekt DkmTransportConnection, který vrací tento port objekt. Pokud port není aktuálně připojený, dojde k selhání ve scénářích vzdáleného ladění a opětovné připojení bylo neúspěšné. Toto rozhraní API bude správně fungovat pouze z hlavního vlákna sady Visual Studio.
FindConnection(Guid)	Vyhledejte objekt DkmTransportConnection. Pokud neexistuje žádný objekt s daným vstupním klíčem, funkce FindConnection selže.
FindLiveProcess(Int32)	Vyhledejte prvek DkmProcess v tomto DkmTransportConnection. Pokud není k dispozici žádný prvek s daným vstupním klíčem, FindLiveProcess selže. Pokud se objekt najde, bude vždy obsahovat živou část.
FindProcess(Guid)	Vyhledejte prvek DkmProcess v tomto DkmTransportConnection. Pokud není k dispozici žádný prvek s daným vstupním klíčem, FindProcess selže.
FindProductionConnection(Guid)	Vyhledejte prvek DkmProductionConnection v tomto DkmTransportConnection. Pokud není k dispozici žádný prvek s daným vstupním klíčem, FindProductionConnection selže. Toto rozhraní API bylo zavedeno v sadě Visual Studio 15 Update 2 (DkmApiVersion.VS15Update2).
FindRecordedProcessInfo(String)	Najít DkmRecordedProcessInfo element v tomto DkmTransportConnection. Pokud není k dispozici žádný prvek s daným vstupním klíčem, FindRecordedProcessInfo selže. Toto rozhraní API bylo zavedeno v sadě Visual Studio 16 RTM (DkmApiVersion.VS16RTM).
FindSerializedProcessInfo(String)	Najít DkmSerializedProcessInfo element v tomto DkmTransportConnection. Pokud není k dispozici žádný prvek s daným vstupním klíčem, FindSerializedProcessInfo selže. Toto rozhraní API bylo zavedeno v sadě Visual Studio 16 Update 8 (DkmApiVersion.VS16Update8).
FlushClosedObjectQueue()	Tato funkce slouží k vynucení okamžité výměny všech oznámení o zavření objektu s procesem monitorování. Jako 'GC. Ve spravovaném kódu je tato funkce obvykle nepotřebná, protože systém frontu automaticky vyprázdní. Tuto metodu však lze použít, pokud je důležité, aby všechny aktualizace byly okamžitě vyměňovány. Vytvoří se oznámení o zavření objektu (a zařadí se do fronty), když komponenta zavolá "Zavřít" u daného objektu. Proces monitorování i proces modulu udržují frontu uzavřených objektů. Tuto metodu lze volat pouze z procesu modulu, ale používá se k vyprázdnění obou front. Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).
GetAppPackageExecutionState(DkmAppPackageId, Int32)	Získejte stav spuštění aplikace pro Windows Store. Hodnoty v tomto poli jsou zadané v PACKAGE_EXECUTION_STATE.
GetClrVersionOfExecutable(String)	Poskytuje řetězec verze modulu CLR, který ladicí program očekává načtení daného spustitelného souboru. Vrácená hodnota je založená na obsahu hlavičky pe spustitelného souboru (pokud je soubor exe spravovaný), konfiguračního souboru spustitelného souboru, proměnných prostředí CLR a zásadách zavaděče v registru. Vrácená hodnota může být nesprávná, zejména v případě nativního spustitelného souboru.
GetConnections()	GetConnections vytvoří výčet všech vytvořených objektů DkmTransportConnection.
GetDataItem<T>()	Získá instanci T, která byla přidána do této instance kontejneru. Pokud tento kontejner neobsahuje T, vrátí tato funkce hodnotu null. (Zděděno od DkmDataContainer)
GetDefaultClrVersion()	Vrátí verzi modulu CLR načtenou v procesu monitorování.
GetDNSName()	Poskytuje název fyzického hostitele DNS, který cílový počítač používá.
GetFileListing(String, String, Boolean)	Získá výpis souborů a podadresářů, které existují v cílovém počítači.
GetIsolatedStorageRootForApplication(DkmAppPackageId)	Získejte úplnou cestu ke kořenovému adresáři izolovaného úložiště pro zadanou aplikaci. Toto rozhraní API ještě není implementované pro aplikace pro Windows Store, ale je vyhrazené pro budoucí použití.
GetLiveProcesses()	GetLiveProcesses vytvoří výčet prvků DkmProcess tohoto objektu DkmTransportConnection. Všechny objekty obsahují živou část.
GetProcesses()	GetProcesses vytvoří výčet prvků DkmProcess tohoto objektu DkmTransportConnection.
GetProductionConnections()	GetProductionConnections vytvoří výčet prvků DkmProductionConnection tohoto objektu DkmTransportConnection. Toto rozhraní API bylo představeno v sadě Visual Studio 15 Update 2 (DkmApiVersion.VS15Update2).
GetRecordedProcesses()	GetRecordedProcesses vytvoří výčet prvků DkmRecordedProcessInfo tohoto objektu DkmTransportConnection. Toto rozhraní API bylo představeno v sadě Visual Studio 16 RTM (DkmApiVersion.VS16RTM).
GetRecordedProcessInfo(String)	Získejte informace o zaznamenaném souboru. Toto rozhraní API bylo představeno v sadě Visual Studio 16 RTM (DkmApiVersion.VS16RTM).
GetRequests()	GetRequests vytvoří výčet DkmProcessLaunchRequest elementů tohoto DkmTransportConnection objektu.
GetRunningProcessInfo(Int32, Int64, Boolean, DkmRunningProcessInfoPropertyMask)	Získejte informace o procesu spuštěném v cílovém počítači.
GetSerializedProcessInfo(String)	Získejte informace o souboru. Toto rozhraní API bylo zavedeno v sadě Visual Studio 16 Update 8 (DkmApiVersion.VS16Update8).
GetSerializedProcessInformation()	GetSerializedProcessInformation vytvoří výčet DkmSerializedProcessInfo elementů tohoto DkmTransportConnection objektu. Toto rozhraní API bylo zavedeno v sadě Visual Studio 16 Update 8 (DkmApiVersion.VS16Update8).
GetSystemInformation(Boolean)	Poskytuje informace o počítači, ve kterém je spuštěno monitorování ladění.
QueryExecutableArchitecture(String)	Získá architekturu spustitelného souboru. Toto rozhraní API bylo představeno v sadě Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview).
QueryIsWOW64Executable(String)	Zastaralé Použijte QueryExecutableArchitecture. Určuje, jestli se daný spustitelný soubor spustí v rámci wow64 (Windows On Windows), který se používá ke spouštění 32bitových procesů v 64bitovém operačním systému.
RemoveAppPackageFromTaskbar(DkmAppPackageId, UInt32)	Odebere ikonu imerzivní aplikace z hlavního panelu tak, že ji zavře. Toto rozhraní API bylo představeno v sadě Visual Studio 12 Update 3 (DkmApiVersion.VS12Update3).
RemoveDataItem<T>()	Odeberte z tohoto kontejneru instanci T. Obvykle není nutné volat tuto metodu, protože kontejner dat se při zavření objektu automaticky vyprázdní. (Zděděno od DkmDataContainer)
RemoveDirectory(String, Boolean)	Odebere adresář v cílovém počítači.
ResumeAppPackage(DkmAppPackageId, Int32)	Provede simulovaný obnovení správy životnosti procesů na základě zadané aplikace. Používají ho vývojáři k testování obslužné rutiny životopisu své aplikace.
SetDataItem<T>(DkmDataCreationDisposition, T)	Do kontejneru dat umístěte novou položku. (Zděděno od DkmDataContainer)
ShutDownAppPackage(DkmWorkList, DkmAppPackageId, Int32, DkmCompletionRoutine<DkmShutDownAppPackageAsyncResult>)	Pozastavte a pak vypněte zadanou aplikaci pomocí služeb správy životnosti procesů. Pomocí této možnosti, po které následuje druhé spuštění aplikace, mohou vývojáři otestovat schopnost své aplikace restartovat se z pozastaveného stavu. Tato metoda připojí novou pracovní položku k zadanému pracovnímu seznamu a vrátí se po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající obdrží oznámení o dokončení žádosti prostřednictvím rutiny dokončení.
SuspendAppPackage(DkmWorkList, DkmAppPackageId, Int32, DkmCompletionRoutine<DkmSuspendAppPackageAsyncResult>)	Provede simulované pozastavení správy na základě správy na základě doby života simulovaného procesu v zadané aplikaci. Tuto rutinu používají vývojáři k testování obslužné rutiny pozastavení své aplikace. Tato metoda připojí novou pracovní položku k zadanému pracovnímu seznamu a vrátí se po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající obdrží oznámení o dokončení žádosti prostřednictvím rutiny dokončení.
TakeNonDebugProcessSnapshot(UInt32)	Pořídí snímek procesu. Jediná data, která se zachovají, jsou samotná snímky. Neexistuje žádný odkaz zpět na nadřazený proces. Toto rozhraní API bylo představeno v sadě Visual Studio 17 Update 6 (DkmApiVersion.VS17Update6).
TerminateAppPackage(DkmWorkList, DkmAppPackageId, Int32, DkmCompletionRoutine<DkmTerminateAppPackageAsyncResult>)	Ukončete balíček aplikace. Používá se k zajištění zastavení všech procesů přidružených k balíčku. Tato metoda připojí novou pracovní položku k zadanému pracovnímu seznamu a vrátí se po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající obdrží oznámení o dokončení žádosti prostřednictvím rutiny dokončení. Toto rozhraní API bylo představeno v sadě Visual Studio 16 Update 9 (DkmApiVersion.VS16Update9).
TerminateRunningProcess(Int32, Int64, Int32)	Ukončí proces spuštěný v cílovém počítači, který není laděný.
TriggerPrefetch(String, DkmPackagedAppPlatform)	Aktivuje předběžné načtení obsahu aplikace. Toto rozhraní API bylo zavedeno v sadě Visual Studio 12 Update 2 (DkmApiVersion.VS12Update2).