MsiGetProductPropertyA-Funktion (msi.h)
Die MsiGetProductProperty Funktion ruft Produkteigenschaften ab. Diese Eigenschaften befinden sich in der Produktdatenbank.
Syntax
UINT MsiGetProductPropertyA(
[in] MSIHANDLE hProduct,
[in] LPCSTR szProperty,
[out] LPSTR lpValueBuf,
[in, out] LPDWORD pcchValueBuf
);
Parameter
[in] hProduct
Behandeln Sie das Produkt von MsiOpenProduct.
[in] szProperty
Gibt die abzurufende Eigenschaft an. Bei dieser Groß-/Kleinschreibung wird die Groß-/Kleinschreibung beachtet.
[out] lpValueBuf
Zeiger auf einen Puffer, der den Eigenschaftswert empfängt. Der Wert wird abgeschnitten und null beendet, wenn lpValueBuf- zu klein ist. Dieser Parameter kann null sein.
[in, out] pcchValueBuf
Zeigen Sie auf eine Variable, die die Größe des Puffers in Zeichen angibt, auf den der lpValueBuf-Parameter verweist. Bei eingaben ist dies die vollständige Größe des Puffers, einschließlich eines Leerzeichens für ein endendes NULL-Zeichen. Wenn der übergebene Puffer zu klein ist, enthält die zurückgegebene Anzahl nicht das endende Nullzeichen.
Wenn lpValueBuf- null ist, kann pcchValueBuf- null sein.
Rückgabewert
Die MsiGetProductProperty--Funktion geben die folgenden Werte zurück.
| Wert | Bedeutung |
|---|---|
|
An die Funktion wurde ein ungültiger Parameter übergeben. |
|
An die Funktion wurde ein ungültiger Handle übergeben. |
|
Ein Puffer ist zu klein, um den gesamten Eigenschaftswert zu halten. |
|
Die Funktion wurde erfolgreich abgeschlossen. |
Bemerkungen
Wenn die MsiGetProductProperty--Funktion zurückgegeben wird, enthält der pcchValueBuf Parameter die Länge der im Puffer gespeicherten Zeichenfolge. Die zurückgegebene Anzahl enthält nicht das endende Nullzeichen. Wenn der Puffer nicht groß genug ist, gibt MsiGetProductProperty ERROR_MORE_DATA zurück, und MsiGetProductProperty- die Größe der Zeichenfolge in Zeichen enthält, ohne das NULL-Zeichen zu zählen.
Anmerkung
Der msi.h-Header definiert MsiGetProductProperty als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Installer 5.0 unter Windows Server 2012, Windows 8, Windows Server 2008 R2 oder Windows 7. Windows Installer 4.0 oder Windows Installer 4.5 unter Windows Server 2008 oder Windows Vista. Windows Installer unter Windows Server 2003 oder Windows XP. Informationen zum mindestens von einer Windows Installer-Version erforderlichen Windows-Service Pack finden Sie unter den Windows Installer-Run-Time Anforderungen. |
| Zielplattform- | Fenster |
| Header- | msi.h |
| Library | Msi.lib |
| DLL- | Msi.dll |