Application Association Registration plug-in: Difference between revisions
| Line 10: | Line 10: | ||
=== Details On Function Parameters === | === Details On Function Parameters === | ||
==== app_name ==== | |||
The value for app_name is the name for the application under: | The value for app_name is the name for the application under: | ||
HKLM\Software\RegisteredApplications\ | HKLM\Software\RegisteredApplications\ | ||
==== assoc_name ==== | |||
The value for assoc_name can be one of the following: | The value for assoc_name can be one of the following: | ||
* For type equals protocol it should be the protocol name (e.g. http, mms, etc.). | |||
* For type equals file it should be the file extension (e.g. .html, .txt, etc.) | |||
* For type equals startmenu it should be the registry subkey name StartMenuInternet, mail, etc.) under: | |||
HKLM\Software\clients | HKLM\Software\clients | ||
* For type equals mime it should be the MIME type name (e.g. audio/mp3, text/html, etc.) | |||
==== type ==== | |||
Possible values for type map to ASSOCIATIONTYPE as follows | Possible values for type map to ASSOCIATIONTYPE as follows | ||
file = AT_FILEEXTENSION | file = AT_FILEEXTENSION | ||
| Line 29: | Line 29: | ||
mime = AT_MIMETYPE | mime = AT_MIMETYPE | ||
==== level ==== | |||
Possible values for level map to ASSOCIATIONLEVEL as follows | Possible values for level map to ASSOCIATIONLEVEL as follows | ||
machine = AL_MACHINE | machine = AL_MACHINE | ||
Revision as of 13:21, 30 September 2007
SetVistaDefaultApp Plugin for NSIS (2007-09-28)
This plugin can set an application as the default handler for all of the handlers it has registered on Vista.
Version: 0.2 (2007-09-28) - minor cleanup.
Version: 0.1 (2007-09-28) - initial release.
Details On Function Parameters
app_name
The value for app_name is the name for the application under:
HKLM\Software\RegisteredApplications\
assoc_name
The value for assoc_name can be one of the following:
- For type equals protocol it should be the protocol name (e.g. http, mms, etc.).
- For type equals file it should be the file extension (e.g. .html, .txt, etc.)
- For type equals startmenu it should be the registry subkey name StartMenuInternet, mail, etc.) under:
HKLM\Software\clients
- For type equals mime it should be the MIME type name (e.g. audio/mp3, text/html, etc.)
type
Possible values for type map to ASSOCIATIONTYPE as follows file = AT_FILEEXTENSION protocol = AT_URLPROTOCOL startMenu = AT_STARTMENUCLIENT mime = AT_MIMETYPE
level
Possible values for level map to ASSOCIATIONLEVEL as follows machine = AL_MACHINE effective = AL_EFFECTIVE user = AL_USER
Functions
AppAssocReg::QueryCurrentDefault assoc_name type level Pop $Var
Determines the default application for a given association type. This is the default application launched by ShellExecute for that type.
Returns:
- 'ProgID' that identifies the current default association.
- 'method failed' if the call failed.
- 'method not available' if IApplicationAssociationRegistration is not available on the system.
AppAssocReg::QueryAppIsDefault app_name assoc_name type level Pop $Var
Determines whether an application owns the registered default assocation for a given application level and type.
Returns:
- '1' if the application is the default.
- '0' if the application is NOT the default.
- 'method failed' if the call failed.
- 'method not available' if IApplicationAssociationRegistration is not available on the system.
AppAssocReg::QueryAppIsDefaultAll app_name level Pop $Var
Determines whether an application owns all of the registered default associations for a given application level.
Returns:
- '1' if the application is the default.
- '0' if the application is NOT the default.
- 'method failed' if the call failed.
- 'method not available' if IApplicationAssociationRegistration is not available on the system.
AppAssocReg::SetAppAsDefault app_name assoc_name type Pop $Var
Sets an application as the default for a given type.
Returns:
- 'success' if the call was successful.
- 'method failed' if the call failed.
- 'method not available' if IApplicationAssociationRegistration is not available on the system.
AppAssocReg::SetAppAsDefaultAll app_name Pop $Var
Sets an application as the default for all of the registered associations of any type for that application.
Returns:
- 'success' if the call was successful.
- 'method failed' if the call failed.
- 'method not available' if IApplicationAssociationRegistration is not available on the system.
AppAssocReg::ClearUserAssociations Pop $Var
Removes all per-user associations for the current user. This results in a reversion to machine defaults, if they exist.
Returns:
- 'success' if the call was successful.
- 'method failed' if the call failed.
- 'method not available' if IApplicationAssociationRegistration is not available on the system.
Example
See Examples\AppAssocReg\Example.nsi
Links
Download
- Current Release: 2007-09-30
AppAssocReg.zip (10 KB)
