Struct netcorehost::hostfxr::DelegateLoader

pub struct DelegateLoader { /* private fields */ }

Available on crate feature netcore3_0 only.

A struct for loading pointers to managed functions for a given HostfxrContext.

Implementations

impl DelegateLoader

pub fn load_assembly_and_get_function<F: FunctionPtr>(
    &self,
    assembly_path: &PdCStr,
    type_name: &PdCStr,
    method_name: &PdCStr,
    delegate_type_name: &PdCStr
) -> Result<ManagedFunction<F::Managed>, GetManagedFunctionError>

Calling this function will load the specified assembly in isolation (into its own AssemblyLoadContext) and it will use AssemblyDependencyResolver on it to provide dependency resolution. Once loaded it will find the specified type and method and return a native function pointer to that method.

Arguments

• assembly_path: Path to the assembly to load. In case of complex component, this should be the main assembly of the component (the one with the .deps.json next to it). Note that this does not have to be the assembly from which the type_name and method_name are.
• type_name: Assembly qualified type name to find
• method_name: Name of the method on the type_name to find. The method must be static and must match the signature of delegate_type_name.
• delegate_type_name: Assembly qualified delegate type name for the method signature.

pub fn load_assembly_and_get_function_with_default_signature(
    &self,
    assembly_path: &PdCStr,
    type_name: &PdCStr,
    method_name: &PdCStr
) -> Result<ManagedFunctionWithDefaultSignature, GetManagedFunctionError>

Calling this function will load the specified assembly in isolation (into its own AssemblyLoadContext) and it will use AssemblyDependencyResolver on it to provide dependency resolution. Once loaded it will find the specified type and method and return a native function pointer to that method.

Arguments

• assembly_path: Path to the assembly to load. In case of complex component, this should be the main assembly of the component (the one with the .deps.json next to it). Note that this does not have to be the assembly from which the type_name and method_name are.
• type_name: Assembly qualified type name to find
• method_name: Name of the method on the type_name to find. The method must be static and must match the following signature: public delegate int ComponentEntryPoint(IntPtr args, int sizeBytes);

pub fn load_assembly_and_get_function_with_unmanaged_callers_only<F: FunctionPtr>(
    &self,
    assembly_path: &PdCStr,
    type_name: &PdCStr,
    method_name: &PdCStr
) -> Result<ManagedFunction<F::Managed>, GetManagedFunctionError>

Calling this function will load the specified assembly in isolation (into its own AssemblyLoadContext) and it will use AssemblyDependencyResolver on it to provide dependency resolution. Once loaded it will find the specified type and method and return a native function pointer to that method. The target method has to be annotated with the UnmanagedCallersOnlyAttribute.

Arguments

• assembly_path: Path to the assembly to load. In case of complex component, this should be the main assembly of the component (the one with the .deps.json next to it). Note that this does not have to be the assembly from which the type_name and method_name are.
• type_name: Assembly qualified type name to find
• method_name: Name of the method on the type_name to find. The method must be static and must match be annotated with [\[UnmanagedCallersOnly\]].

pub fn get_function<F: FunctionPtr>(
    &self,
    type_name: &PdCStr,
    method_name: &PdCStr,
    delegate_type_name: &PdCStr
) -> Result<ManagedFunction<F::Managed>, GetManagedFunctionError>

Calling this function will find the specified type and method and return a native function pointer to that method. This will NOT load the containing assembly.

Arguments

• type_name: Assembly qualified type name to find
• method_name: Name of the method on the type_name to find. The method must be static and must match the signature of delegate_type_name.
• delegate_type_name: Assembly qualified delegate type name for the method signature.

pub fn get_function_with_default_signature(
    &self,
    type_name: &PdCStr,
    method_name: &PdCStr
) -> Result<ManagedFunctionWithDefaultSignature, GetManagedFunctionError>

Calling this function will find the specified type and method and return a native function pointer to that method. This will NOT load the containing assembly.

Arguments

• type_name: Assembly qualified type name to find
• method_name: Name of the method on the type_name to find. The method must be static and must match the following signature: public delegate int ComponentEntryPoint(IntPtr args, int sizeBytes);

pub fn get_function_with_unmanaged_callers_only<F: FunctionPtr>(
    &self,
    type_name: &PdCStr,
    method_name: &PdCStr
) -> Result<ManagedFunction<F::Managed>, GetManagedFunctionError>

Calling this function will find the specified type and method and return a native function pointer to that method. This will NOT load the containing assembly.

Arguments

• type_name: Assembly qualified type name to find
• method_name: Name of the method on the type_name to find. The method must be static and must match be annotated with UnmanagedCallersOnly.

Trait Implementations

impl Clone for DelegateLoader

fn clone(&self) -> DelegateLoader

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.