DkmModule.Create 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| Create(DkmModuleId, String, DkmCompilerId, DkmTransportConnection, DkmDataItem) |
创建一个新的 DkmModule 对象，该对象表示一个或多个加载的模块 (模块实例) 的符号。 这些对象由符号提供程序创建。 创建 DkmModule 对象后，符号提供程序应调用 DkmModuleInstance.SetModule 以将 DkmModuleInstance 和 DkmModule 关联在一起。 此方法将发送 ModuleCreate 事件。 |
| Create(DkmModuleId, String, DkmCompilerId, DkmTransportConnection, DkmWorkerProcessConnection, String, DkmDataItem) |
创建一个新的 DkmModule 对象，该对象表示一个或多个加载的模块 (模块实例) 的符号。 这些对象由符号提供程序创建。 创建 DkmModule 对象后，符号提供程序应调用 DkmModuleInstance.SetModule 以将 DkmModuleInstance 和 DkmModule 关联在一起。 此方法将发送 ModuleCreate 事件。 此 API 是在 Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview) 中引入的。 |
| Create(DkmModuleId, String, DkmCompilerId, DkmTransportConnection, DkmWorkerProcessConnection, String, DkmModuleSymbolFlags, DkmDataItem) |
创建一个新的 DkmModule 对象，该对象表示一个或多个加载的模块 (模块实例) 的符号。 这些对象由符号提供程序创建。 创建 DkmModule 对象后，符号提供程序应调用 DkmModuleInstance.SetModule 以将 DkmModuleInstance 和 DkmModule 关联在一起。 此方法将发送 ModuleCreate 事件。 此 API 是在 Visual Studio 17 Update 2 (DkmApiVersion.VS17Update2) 中引入的。 |
Create(DkmModuleId, String, DkmCompilerId, DkmTransportConnection, DkmDataItem)
创建一个新的 DkmModule 对象，该对象表示一个或多个加载的模块 (模块实例) 的符号。 这些对象由符号提供程序创建。 创建 DkmModule 对象后，符号提供程序应调用 DkmModuleInstance.SetModule 以将 DkmModuleInstance 和 DkmModule 关联在一起。
此方法将发送 ModuleCreate 事件。
public:
static Microsoft::VisualStudio::Debugger::Symbols::DkmModule ^ Create(Microsoft::VisualStudio::Debugger::Symbols::DkmModuleId Id, System::String ^ Name, Microsoft::VisualStudio::Debugger::Evaluation::DkmCompilerId CompilerId, Microsoft::VisualStudio::Debugger::DefaultPort::DkmTransportConnection ^ Connection, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);public static Microsoft.VisualStudio.Debugger.Symbols.DkmModule Create (Microsoft.VisualStudio.Debugger.Symbols.DkmModuleId Id, string Name, Microsoft.VisualStudio.Debugger.Evaluation.DkmCompilerId CompilerId, Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection Connection, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);public static Microsoft.VisualStudio.Debugger.Symbols.DkmModule Create (Microsoft.VisualStudio.Debugger.Symbols.DkmModuleId Id, string Name, Microsoft.VisualStudio.Debugger.Evaluation.DkmCompilerId CompilerId, Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection? Connection, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);static member Create : Microsoft.VisualStudio.Debugger.Symbols.DkmModuleId * string * Microsoft.VisualStudio.Debugger.Evaluation.DkmCompilerId * Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Symbols.DkmModulePublic Shared Function Create (Id As DkmModuleId, Name As String, CompilerId As DkmCompilerId, Connection As DkmTransportConnection, DataItem As DkmDataItem) As DkmModule参数
- Id
- DkmModuleId
[In]用于唯一标识特定 DkmModule 实例的 Guid 对。
- Name
- String
[In]模块的名称。
- CompilerId
- DkmCompilerId
[In]生成此模块中所有代码的编译器的 LanguageId/VendorId。 如果模块可能包含混合语言，则为 Guid.Empty/Guid.Empty。 对于基于 PDB 的模块，这几乎始终是 Guid.Empty/Guid.Empty。 动态语言通常用于避免网络往返来发现每个符号的语言。
- Connection
- DkmTransportConnection
[In，Optional]对于远程加载符号的模块，连接属性用于确定连接的来源。 否则，此值将为 NULL。
- DataItem
- DkmDataItem
[In，Optional]要添加到新 DkmModule 实例的数据对象。 如果调用方不需要添加数据项，则传递“null”。
返回
[Out]此方法调用的结果。
适用于
Create(DkmModuleId, String, DkmCompilerId, DkmTransportConnection, DkmWorkerProcessConnection, String, DkmDataItem)
创建一个新的 DkmModule 对象，该对象表示一个或多个加载的模块 (模块实例) 的符号。 这些对象由符号提供程序创建。 创建 DkmModule 对象后，符号提供程序应调用 DkmModuleInstance.SetModule 以将 DkmModuleInstance 和 DkmModule 关联在一起。
此方法将发送 ModuleCreate 事件。
此 API 是在 Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview) 中引入的。
public:
static Microsoft::VisualStudio::Debugger::Symbols::DkmModule ^ Create(Microsoft::VisualStudio::Debugger::Symbols::DkmModuleId Id, System::String ^ Name, Microsoft::VisualStudio::Debugger::Evaluation::DkmCompilerId CompilerId, Microsoft::VisualStudio::Debugger::DefaultPort::DkmTransportConnection ^ Connection, Microsoft::VisualStudio::Debugger::DefaultPort::DkmWorkerProcessConnection ^ SymbolsConnection, System::String ^ FilePath, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);public static Microsoft.VisualStudio.Debugger.Symbols.DkmModule Create (Microsoft.VisualStudio.Debugger.Symbols.DkmModuleId Id, string Name, Microsoft.VisualStudio.Debugger.Evaluation.DkmCompilerId CompilerId, Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection Connection, Microsoft.VisualStudio.Debugger.DefaultPort.DkmWorkerProcessConnection SymbolsConnection, string FilePath, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);public static Microsoft.VisualStudio.Debugger.Symbols.DkmModule Create (Microsoft.VisualStudio.Debugger.Symbols.DkmModuleId Id, string Name, Microsoft.VisualStudio.Debugger.Evaluation.DkmCompilerId CompilerId, Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection? Connection, Microsoft.VisualStudio.Debugger.DefaultPort.DkmWorkerProcessConnection? SymbolsConnection, string? FilePath, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);static member Create : Microsoft.VisualStudio.Debugger.Symbols.DkmModuleId * string * Microsoft.VisualStudio.Debugger.Evaluation.DkmCompilerId * Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection * Microsoft.VisualStudio.Debugger.DefaultPort.DkmWorkerProcessConnection * string * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Symbols.DkmModulePublic Shared Function Create (Id As DkmModuleId, Name As String, CompilerId As DkmCompilerId, Connection As DkmTransportConnection, SymbolsConnection As DkmWorkerProcessConnection, FilePath As String, DataItem As DkmDataItem) As DkmModule参数
- Id
- DkmModuleId
[In]用于唯一标识特定 DkmModule 实例的 Guid 对。
- Name
- String
[In]模块的名称。
- CompilerId
- DkmCompilerId
[In]生成此模块中所有代码的编译器的 LanguageId/VendorId。 如果模块可能包含混合语言，则为 Guid.Empty/Guid.Empty。 对于基于 PDB 的模块，这几乎始终是 Guid.Empty/Guid.Empty。 动态语言通常用于避免网络往返来发现每个符号的语言。
- Connection
- DkmTransportConnection
[In，Optional]对于远程加载符号的模块，连接属性用于确定连接的来源。 否则，此值将为 NULL。
- SymbolsConnection
- DkmWorkerProcessConnection
[In，Optional]如果为非 null，则指定与处理此 DkmModule 符号的工作进程的连接。 如果在 IDE 进程中加载符号，或者在远程调试器中加载符号 (DkmModule.Connection) 为非 null，则该值为 null。
- FilePath
- String
[In，Optional]如果指定，则包含符号文件的完整路径，该符号文件后备 DkmModule (例如：c：\myproj\bin\Debug\myproj.pdb) 。
- DataItem
- DkmDataItem
[In，Optional]要添加到新 DkmModule 实例的数据对象。 如果调用方不需要添加数据项，则传递“null”。
返回
[Out]此方法调用的结果。
适用于
Create(DkmModuleId, String, DkmCompilerId, DkmTransportConnection, DkmWorkerProcessConnection, String, DkmModuleSymbolFlags, DkmDataItem)
创建一个新的 DkmModule 对象，该对象表示一个或多个加载的模块 (模块实例) 的符号。 这些对象由符号提供程序创建。 创建 DkmModule 对象后，符号提供程序应调用 DkmModuleInstance.SetModule 以将 DkmModuleInstance 和 DkmModule 关联在一起。
此方法将发送 ModuleCreate 事件。
此 API 是在 Visual Studio 17 Update 2 (DkmApiVersion.VS17Update2) 中引入的。
public static Microsoft.VisualStudio.Debugger.Symbols.DkmModule Create (Microsoft.VisualStudio.Debugger.Symbols.DkmModuleId Id, string Name, Microsoft.VisualStudio.Debugger.Evaluation.DkmCompilerId CompilerId, Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection? Connection, Microsoft.VisualStudio.Debugger.DefaultPort.DkmWorkerProcessConnection? SymbolsConnection, string? FilePath, Microsoft.VisualStudio.Debugger.Symbols.DkmModuleSymbolFlags Flags, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);static member Create : Microsoft.VisualStudio.Debugger.Symbols.DkmModuleId * string * Microsoft.VisualStudio.Debugger.Evaluation.DkmCompilerId * Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection * Microsoft.VisualStudio.Debugger.DefaultPort.DkmWorkerProcessConnection * string * Microsoft.VisualStudio.Debugger.Symbols.DkmModuleSymbolFlags * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Symbols.DkmModulePublic Shared Function Create (Id As DkmModuleId, Name As String, CompilerId As DkmCompilerId, Connection As DkmTransportConnection, SymbolsConnection As DkmWorkerProcessConnection, FilePath As String, Flags As DkmModuleSymbolFlags, DataItem As DkmDataItem) As DkmModule参数
- Id
- DkmModuleId
[In]用于唯一标识特定 DkmModule 实例的 Guid 对。
- Name
- String
[In]模块的名称。
- CompilerId
- DkmCompilerId
[In]生成此模块中所有代码的编译器的 LanguageId/VendorId。 如果模块可能包含混合语言，则为 Guid.Empty/Guid.Empty。 对于基于 PDB 的模块，这几乎始终是 Guid.Empty/Guid.Empty。 动态语言通常用于避免网络往返来发现每个符号的语言。
- Connection
- DkmTransportConnection
[In，Optional]对于远程加载符号的模块，连接属性用于确定连接的来源。 否则，此值将为 NULL。
- SymbolsConnection
- DkmWorkerProcessConnection
[In，Optional]如果为非 null，则指定与处理此 DkmModule 符号的工作进程的连接。 如果在 IDE 进程中加载符号，或者在远程调试器中加载符号 (DkmModule.Connection) 为非 null，则该值为 null。
- FilePath
- String
[In，Optional]如果指定，则包含符号文件的完整路径，该符号文件后备 DkmModule (例如：c：\myproj\bin\Debug\myproj.pdb) 。
- Flags
- DkmModuleSymbolFlags
[In]指示此 DkmModule 对象的特征的标志。
- DataItem
- DkmDataItem
[In，Optional]要添加到新 DkmModule 实例的数据对象。 如果调用方不需要添加数据项，则传递“null”。
返回
[Out]此方法调用的结果。