Функция MsiGetProductInfoExA (msi.h)

Функция MsiGetProductInfoEx возвращает сведения о продукте для объявленных и установленных продуктов. Эта функция может получить сведения

о экземпляре продукта, установленного под учетной записью пользователя, отличной от текущего пользователя.

Вызывающий процесс должен иметь права администратора для пользователя, который отличается от текущего пользователя. Функция MsiGetProductInfoEx не может запрашивать экземпляр продукта, объявленного в контексте, неуправляемом пользователем, для учетной записи пользователя, отличной от текущего пользователя.

Эта функция является расширением функции MsiGetProductInfo .

Синтаксис

UINT MsiGetProductInfoExA(
  [in]                LPCSTR            szProductCode,
  [in]                LPCSTR            szUserSid,
  [in]                MSIINSTALLCONTEXT dwContext,
  [in]                LPCSTR            szProperty,
  [out, optional]     LPSTR             szValue,
  [in, out, optional] LPDWORD           pcchValue
);

Параметры

[in] szProductCode

GUID ProductCode для экземпляра продукта, запрашиваемого.

[in] szUserSid

Идентификатор безопасности учетной записи, в которой существует экземпляр продукта, запрашиваемого. Значение NULL указывает текущий идентификатор безопасности пользователя.

[in] dwContext

Контекст установки экземпляра продукта, запрашиваемого.

[in] szProperty

Свойство запрашивается.

Извлекаемое свойство. Свойства в следующей таблице можно получить только из установленных приложений. Все необходимые свойства гарантированно доступны, но другие свойства доступны только в том случае, если свойство задано. Для получения дополнительных сведений см.
Обязательные свойства и свойства.

Чтобы получить идентификатор продукта, зарегистрированный владелец или зарегистрированную компанию из установленных приложений, задайте для szProperty одно из следующих текстовых строковых значений.

Чтобы получить тип экземпляра продукта, задайте для параметра szProperty следующее значение. Это свойство доступно для объявленных или установленных продуктов.

Свойства в следующей таблице можно получить из приложений, объявленных или установленных. Эти свойства нельзя получить для экземпляров продукта, установленных в контексте неуправляемого пользователя для учетных записей пользователей, отличных от текущей учетной записи пользователя.

[out, optional] szValue

Указатель на буфер, получающий значение свойства. Этот буфер должен быть достаточно большим, чтобы содержать информацию. Если буфер слишком мал, функция возвращает ERROR_MORE_DATA и задает *pcchValue число TCHAR в значении, не включая завершающий символ NULL.

Если для lpValue задано значение NULL , а pcchValue имеется допустимый указатель, функция возвращает ERROR_SUCCESS и задает *pcchValue числу TCHAR в значении, не включая завершающий символ NULL. Затем функцию можно вызвать еще раз, чтобы получить значение, с буфером lpValue достаточно большим, чтобы содержать *pcchValue + 1 символов.

Если значение lpValue и pcchValue имеют значение NULL, функция возвращает ERROR_SUCCESS , если значение существует, не извлекая значение.

[in, out, optional] pcchValue

Указатель на переменную, указывающую число TCHAR в буфере lpValue . При возврате функции этот параметр имеет размер запрошенного значения, копирует ли функция значение в указанный буфер. Размер возвращается в виде числа TCHAR в запрошенном значении, а не включая завершающийся пустой символ.

Этот параметр может иметь значение NULL , только если значение lpValue также равно NULL. В противном случае функция возвращает ERROR_INVALID_PARAMETER.

Возвращаемое значение

Функция MsiGetProductInfoEx возвращает следующие значения.

Замечания

При возврате функции MsiGetProductInfoEx параметр pcchValue содержит длину строки, хранящейся в буфере. Возвращаемое число не включает завершающийся символ NULL. Если буфер недостаточно велик, MsiGetProductInfoEx возвращает ERROR_MORE_DATA, а параметр pcchValue содержит размер строки в TCHAR без подсчета символа NULL.

Функция MsiGetProductInfoEx (INSTALLPROPERTY_LOCALPACKAGE) возвращает путь к кэшированному пакету. Кэшированный пакет предназначен только для внутреннего использования. Установка режима обслуживания должна вызываться с помощью функций MsiConfigureFeature, MsiConfigureProduct или MsiConfigureProductEx.

Функция MsiGetProductInfo возвращает ERROR_UNKNOWN_PROPERTY , если запрашиваемое приложение объявляется и не установлено. Например, если приложение объявлено и не установлено, запрос на INSTALLPROPERTY_INSTALLLOCATION возвращает ошибку ERROR_UNKNOWN_PROPERTY.

Требования

См. также

ARPHELPLINK

ARPHELPTELEPHONE

ARPINSTALLLOCATION

ARPPRODUCTICON

ARPURLINFOABOUT

ARPURLUPDATEINFO

Производитель

MsiConfigureFeature

MsiConfigureProduct

MsiConfigureProductEx

Не поддерживается в установщике Windows 2.0 и более ранних версий

Коды пакетов

ProductCode

ProductID

ProductName

ProductVersion

Свойства

Обязательные свойства

SourceDir

Функции состояния системы