Share via


INSTALLERINFO structure

Starting in Windows 10 Version 1607 (Redstone 1), the Driver Install Frameworks (DIFx) tools are no longer included in the WDK.

For more information, see DIFx Guidelines.

The INSTALLERINFO structure contains information about an application that DIFxAPI associates with a driver package.

Syntax

typedef struct {
  PCTSTR pApplicationId;
  PCTSTR pDisplayName;
  PCTSTR pProductName;
  PCTSTR pMfgName;
} INSTALLERINFO, *PINSTALLERINFO;

Members

pApplicationId

A pointer to a NULL-terminated string that supplies a vendor-defined token. DIFxAPI uses this token to associate an application with the driver package. We recommend that the token be a unique application-specific value, such as a GUID. DIFxAPI does not enforce uniqueness among the tokens. If a caller supplies an INSTALLERINFO structure that specifies an association between an application and a driver package, this member must not be NULL or supply an empty string.

pDisplayName

A pointer to a constant NULL-terminated string that supplies the display name of an application that is associated with a driver package. DIFxAPI requires an application display name to inform a user which application is associated with a driver package.

For example, for each driver package that is installed by the DIFx tools, an entry, which represents the driver package, is added to Programs and Features in Control Panel. If a user clicks on the Uninstall/Change button of this Programs and Features entry, the resulting dialog box lists the display names of the applications that are associated with the driver package. If a caller supplies an INSTALLERINFO structure that specifies an association between an application and a driver package, this member must not be NULL or supply an empty string.

Note

In versions of Windows earlier than Windows Vista, the DIFx tools added the entry for the driver package to Add or Remove Programs in Control Panel.

pProductName

A pointer to a constant NULL-terminated string that supplies the name of the product for an application that is associated with a driver package. If a caller supplies an INSTALLERINFO structure that specifies an association between an application and a driver package, this member must not be NULL or supply an empty string.

pMfgName

A pointer to a constant NULL-terminated string that supplies the name of the manufacturer of the application that is associated with a driver package. If a caller supplies an INSTALLERINFO structure that specifies an association between an application and a driver package, this member must not be NULL or supply an empty string.

Remarks

The INSTALLERINFO structure is defined specifically as an input parameter to DriverPackageInstall and DriverPackageUninstall. If a caller supplies a non-NULL INSTALLERINFO structure to these functions, all members of the structure must supply non-empty string values; otherwise, these functions return ERROR_INVALID_PARAMETER.

A caller that supplies application information to install a driver package should use the same information to uninstall the driver package. Otherwise, the correct association between applications and the driver package cannot be maintained.

Requirements

Header Difxapi.h (include Difxapi.h)

See also

DriverPackageInstall

DriverPackageUninstall