Zero Install .NET API 2.20.0
ZeroInstall.DesktopIntegration.Windows.RegistryClasses Class Reference

Helpers for registering Capabilitys in the HKCR section of the Windows Registry. More...

Static Public Member Functions

static RegistryKey OpenHive (bool machineWide)
 Opens the HKCU/HKLM registry key backing HKCR.
 
static void Register (RegistryKey registryKey, FeedTarget target, VerbCapability capability, IIconStore iconStore, bool machineWide)
 Registers a VerbCapability in a registry key. More...
 
static void Register (RegistryKey verbKey, FeedTarget target, Verb verb, IIconStore iconStore, bool machineWide)
 Registers a Verb in a registry key. More...
 

Static Public Attributes

const string Prefix = "ZeroInstall."
 Prepended before any programmatic identifiers used by Zero Install in the registry. This prevents conflicts with non-Zero Install installations.
 
const string PurposeFlagPrefix = "ZeroInstall."
 Prepended before any registry purpose flags. Purpose flags indicate what a registry key was created for and whether it is still required.
 
const string PurposeFlagCapability = PurposeFlagPrefix + "Capability"
 Indicates a registry key is required by a capability.
 
const string PurposeFlagAccessPoint = PurposeFlagPrefix + "AccessPoint"
 Indicates a registry key is required by an access point.
 

Static Package Functions

static string GetLaunchCommandLine (FeedTarget target, Verb verb, IIconStore iconStore, bool machineWide)
 Generates a command-line string for launching a Verb. More...
 

Detailed Description

Helpers for registering Capabilitys in the HKCR section of the Windows Registry.

Member Function Documentation

◆ GetLaunchCommandLine()

static string ZeroInstall.DesktopIntegration.Windows.RegistryClasses.GetLaunchCommandLine ( FeedTarget  target,
Verb  verb,
IIconStore  iconStore,
bool  machineWide 
)
inlinestaticpackage

Generates a command-line string for launching a Verb.

Parameters
targetThe application being integrated.
verbThe verb to get to launch command for.
iconStoreStores icon files downloaded from the web as local files.
machineWideStore the stub in a machine-wide directory instead of just for the current user.
Exceptions
IOExceptionA problem occurred while writing to the filesystem.
WebExceptionA problem occurred while downloading additional data (such as icons).
InvalidOperationExceptionWrite access to the filesystem is not permitted.

◆ Register() [1/2]

static void ZeroInstall.DesktopIntegration.Windows.RegistryClasses.Register ( RegistryKey  registryKey,
FeedTarget  target,
VerbCapability  capability,
IIconStore  iconStore,
bool  machineWide 
)
inlinestatic

Registers a VerbCapability in a registry key.

Parameters
registryKeyThe registry key to write the new data to.
targetThe application being integrated.
capabilityThe capability to register.
iconStoreStores icon files downloaded from the web as local files.
machineWideAssume registryKey is effective machine-wide instead of just for the current user.
Exceptions
OperationCanceledExceptionThe user canceled the task.
IOExceptionA problem occurred while writing to the filesystem or registry.
WebExceptionA problem occurred while downloading additional data (such as icons).
UnauthorizedAccessExceptionWrite access to the filesystem or registry is not permitted.

◆ Register() [2/2]

static void ZeroInstall.DesktopIntegration.Windows.RegistryClasses.Register ( RegistryKey  verbKey,
FeedTarget  target,
Verb  verb,
IIconStore  iconStore,
bool  machineWide 
)
inlinestatic

Registers a Verb in a registry key.

Parameters
verbKeyThe registry key to write the new data to.
targetThe application being integrated.
verbThe verb to register.
iconStoreStores icon files downloaded from the web as local files.
machineWideAssume verbKey is effective machine-wide instead of just for the current user.
Exceptions
OperationCanceledExceptionThe user canceled the task.
IOExceptionA problem occurred while writing to the filesystem or registry.
WebExceptionA problem occurred while downloading additional data (such as icons).
UnauthorizedAccessExceptionWrite access to the filesystem or registry is not permitted.

The documentation for this class was generated from the following file: