MsiGetProductInfoExA-Funktion (msi.h)

Die MsiGetProductInfoEx-Funktion gibt Produktinformationen für angekündigte und installierte Produkte zurück. Diese Funktion kann Informationen abrufen.

über eine Instanz eines Produkts, das unter einem anderen Benutzerkonto als dem aktuellen Benutzer installiert ist.

Der Aufrufvorgang muss über Administratorrechte für einen Benutzer verfügen, der sich von dem aktuellen Benutzer unterscheidet. Die MsiGetProductInfoEx-Funktion kann keine Instanz eines Produkts abfragen, das unter einem nicht verwalteten Kontext pro Benutzer für ein anderes Benutzerkonto als den aktuellen Benutzer angekündigt wird.

Diese Funktion ist eine Erweiterung der MsiGetProductInfo-Funktion .

Syntax

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

Die Parameter

[in] szProductCode

Die ProductCode-GUID der Produktinstanz, die abgefragt wird.

[in] szUserSid

Die Sicherheits-ID (SID) des Kontos, unter dem die Instanz des abgefragten Produkts vorhanden ist. Ein NULL-Wert gibt die aktuelle Benutzer-SID an.

[in] dwContext

Der Installationskontext der Produktinstanz, die abgefragt wird.

[in] szProperty

Die abgefragte Eigenschaft.

Die abzurufende Eigenschaft. Die Eigenschaften in der folgenden Tabelle können nur aus Anwendungen abgerufen werden, die bereits installiert sind. Alle erforderlichen Eigenschaften sind garantiert verfügbar, aber andere Eigenschaften sind nur verfügbar, wenn die Eigenschaft festgelegt ist. Weitere Informationen finden Sie unter
Erforderliche Eigenschaften und Eigenschaften.

Um die Produkt-ID, den registrierten Besitzer oder das registrierte Unternehmen aus installierten Anwendungen abzurufen, legen Sie szProperty auf einen der folgenden Textzeichenfolgenwerte fest.

Um den Instanztyp des Produkts abzurufen, legen Sie "szProperty " auf den folgenden Wert fest. Diese Eigenschaft ist für angekündigte oder installierte Produkte verfügbar.

Die Eigenschaften in der folgenden Tabelle können aus Anwendungen abgerufen werden, die angekündigt oder installiert werden. Diese Eigenschaften können nicht für Produktinstanzen abgerufen werden, die unter einem nicht verwalteten Kontext für Benutzerkonten installiert werden, die nicht verwaltet werden, außer für das aktuelle Benutzerkonto.

[out, optional] szValue

Ein Zeiger auf einen Puffer, der den Eigenschaftswert empfängt. Dieser Puffer sollte groß genug sein, um die Informationen zu enthalten. Wenn der Puffer zu klein ist, gibt die Funktion ERROR_MORE_DATA zurück und legt *pcchValue auf die Anzahl der TCHAR im Wert fest, nicht einschließlich des endenden NULL-Zeichens.

Wenn lpValue auf NULL festgelegt ist und pcchValue auf einen gültigen Zeiger festgelegt ist, gibt die Funktion ERROR_SUCCESS zurück und legt *pcchValue auf die Anzahl der TCHAR im Wert fest, nicht einschließlich des endenden NULL-Zeichens. Die Funktion kann dann erneut aufgerufen werden, um den Wert abzurufen, wobei der lpValue-Puffer groß genug ist, um *pcchValue + 1 Zeichen zu enthalten.

Wenn lpValue und pcchValue beide auf NULL festgelegt sind, gibt die Funktion ERROR_SUCCESS zurück, wenn der Wert vorhanden ist, ohne den Wert abzurufen.

[in, out, optional] pcchValue

Ein Zeiger auf eine Variable, die die Anzahl der TCHAR im lpValue-Puffer angibt. Wenn die Funktion zurückgegeben wird, wird dieser Parameter auf die Größe des angeforderten Werts festgelegt, unabhängig davon, ob die Funktion den Wert in den angegebenen Puffer kopiert. Die Größe wird als Die Anzahl der TCHAR im angeforderten Wert zurückgegeben, nicht einschließlich des endenden NULL-Zeichens.

Dieser Parameter kann nur auf NULL festgelegt werden, wenn lpValue ebenfalls NULL ist. Andernfalls gibt die Funktion ERROR_INVALID_PARAMETER zurück.

Rückgabewert

Die MsiGetProductInfoEx-Funktion gibt die folgenden Werte zurück.

Bemerkungen

Wenn die MsiGetProductInfoEx-Funktion zurückgegeben wird, enthält der Parameter "pcchValue " die Länge der Zeichenfolge, die im Puffer gespeichert ist. Die zurückgegebene Anzahl enthält nicht das endende Nullzeichen. Wenn der Puffer nicht groß genug ist, gibt MsiGetProductInfoExERROR_MORE_DATA zurück, und der Parameter pcchValue enthält die Größe der Zeichenfolge in TCHAR, ohne das Nullzeichen zu zählen.

Die MsiGetProductInfoEx-Funktion (INSTALLPROPERTY_LOCALPACKAGE) gibt einen Pfad zum zwischengespeicherten Paket zurück. Das zwischengespeicherte Paket ist nur für die interne Verwendung vorgesehen. Wartungsmodusinstallationen müssen über die Funktionen MsiConfigureFeature, MsiConfigureProduct oder MsiConfigureProductEx aufgerufen werden.

Die MsiGetProductInfo-Funktion gibt ERROR_UNKNOWN_PROPERTY zurück, wenn die abgefragte Anwendung angekündigt und nicht installiert ist. Wenn die Anwendung beispielsweise angekündigt und nicht installiert ist, gibt eine Abfrage für INSTALLPROPERTY_INSTALLLOCATION einen Fehler von ERROR_UNKNOWN_PROPERTY zurück.

Anforderungen

Siehe auch

ARPHELPLINK

ARPHELPTELEPHONE

ARPINSTALLLOCATION

ARPPRODUCTICON

ARPURLINFOABOUT

ARPURLUPDATEINFO

Hersteller

MsiConfigureFeature

MsiConfigureProduct

MsiConfigureProductEx

In Windows Installer 2.0 und früheren Versionen nicht unterstützt

Paketcodes

ProductCode

ProductID

ProductName

ProductVersion

Eigenschaften

Erforderliche Eigenschaften

SourceDir

Systemstatusfunktionen