binds a package URL to a XPackage handle.
The returned UNO package handle ought to late-initialize itself,
thus the process of binding must not be an expensive operation, because
it is not abortable.
Calling the function several time with the same parameters must result
in returning the same object.
The file or folder at the location where url points to may not exist or
it was replaced. This can happen, for example, when a bundled extension
was removed by the setup and a user later starts OOo. Then the user data
may still contain all registration data of that extension, but the
actual extension files do not exist anymore. The registration data must
then be cleaned of all the remains of that extension. To to that one
creates an XPackage object on behalf of that extension and
calls XPackage::revokePakage. The parameter
removed indicates this case. The returned object may not
rely on the file or folder to which refers url. Instead it
must use previously saved data to successfully carry out the revocation
of this object (XPackage::revokePackage).
The implementation must ensure that there is only one instance of
XPackage for the same url at any
time. Therefore calling bindPackage again with the same
url but different mediaType (the exeption is,
if previsously an empty string was proveded to cause the determination
of the media type) or removed parameters will cause an
exception. An ::com::sun::star::lang::IllegalArgumentException will be
thrown in case of a different mediaType parameter and a
InvalidRemovedParameterException is thrown if the
removed parameter is different.
The identifier parameter must be provided when
removed = true. If not, then an ::com::sun::star::lang::IllegalArgumentException will be
thrown.
binds a package URL to a XPackage handle.
The returned UNO package handle ought to late-initialize itself,
thus the process of binding must not be an expensive operation, because
it is not abortable.
Calling the function several time with the same parameters must result
in returning the same object.
The file or folder at the location where url points to may not exist or
it was replaced. This can happen, for example, when a bundled extension
was removed by the setup and a user later starts OOo. Then the user data
may still contain all registration data of that extension, but the
actual extension files do not exist anymore. The registration data must
then be cleaned of all the remains of that extension. To to that one
creates an XPackage object on behalf of that extension and
calls XPackage::revokePakage. The parameter
removed indicates this case. The returned object may not
rely on the file or folder to which refers url. Instead it
must use previously saved data to successfully carry out the revocation
of this object (XPackage::revokePackage).
The implementation must ensure that there is only one instance of
XPackage for the same url at any
time. Therefore calling bindPackage again with the same
url but different mediaType (the exeption is,
if previsously an empty string was proveded to cause the determination
of the media type) or removed parameters will cause an
exception. An ::com::sun::star::lang::IllegalArgumentException will be
thrown in case of a different mediaType parameter and a
InvalidRemovedParameterException is thrown if the
removed parameter is different.
The identifier parameter must be provided when
removed = true. If not, then an ::com::sun::star::lang::IllegalArgumentException will be
thrown.
Parameter url
package URL, must be UCB conform
Parameter mediaType
media type of package, empty string if to be detected
Parameter removed
@para unfulfilledPrerequisites
has a value other null if the extension could not be installed previously
because XPackage::checkPrerequisites failed.
Parameter identifier
the identifier of the extension
Parameter xCmdEnv
command environment for error and progress handling
