IAppVClient::ConfigurePackage method

Adds a new package to the Client, or modifies the configuration of an existing package.

[This API is deprecated and may unsupported or unavailable in future versions of Windows.]

Syntax

HRESULT ConfigurePackage(
    [in] BSTR packageGUID,
    [in] BSTR packageVersionGUID, 
    [in] BSTR url, 
    [in] BSTR policy,
    [in] VARIANT policyTime, 
    [out, retval] ULONGLONG* appvret);

Parameters

packageGUID [in]

Required. The ID of the package to configure.

packageVersionGUID [in]

Required. The package version ID.

url [in]

The package URL. This parameter is optional (NULL or empty string) only if the package version is already configured, in which case the URL remains unchanged. This parameter is required when adding a new package version.

policy [in]

The path to a new Machine Policy document file. This parameter is optional (NULL or empty string) only if the package version is already configured, in which case the policy remains unchanged. This parameter is required when adding a new package version.

The Client will accept a special, case-insensitive value of "<DEFAULT>" to indicate that the App-V-defined default Machine Policy for the package should be applied.

policyTime [in]

A VT_DATE representing the UDT last modification time of the given policy. If not provided, “now” (UDT) will be used. If policy is not provided, policyTime is ignored.

appvret [out]

An App-V return code.

Return value

An HRESULT.

Remarks

This is a privileged operation, and requires administrative rights or membership in the appropriate security group. If the GUIDs are not known, the method RetrieveGuidsFromPackageURL may be used to discover them.

Requirements

Requirement	Value
Header	N/A

See also