MsiEnumComponentsW-Funktion (msi.h)
Die Funktion MsiEnumComponents zählt die installierten Komponenten für alle Produkte auf. Diese Funktion ruft jeweils einen Komponentencode ab, wenn er aufgerufen wird.
Syntax
UINT MsiEnumComponentsW(
[in] DWORD iComponentIndex,
[out] LPWSTR lpComponentBuf
);
Parameter
[in] iComponentIndex
Gibt den Index der zu abrufenden Komponente an. Dieser Parameter sollte für den ersten Aufruf der Funktion MsiEnumComponents null sein und dann für nachfolgende Aufrufe inkrementiert werden. Da Komponenten nicht angeordnet sind, weist jede neue Komponente einen beliebigen Index auf. Dies bedeutet, dass die Funktion Komponenten in beliebiger Reihenfolge zurückgeben kann.
[out] lpComponentBuf
Zeiger auf einen Puffer, der den Komponentencode empfängt. Dieser Puffer muss 39 Zeichen lang sein. Die ersten 38 Zeichen sind für die GUID und das letzte Zeichen für das Endzeichen null.
Rückgabewert
| Wert | Bedeutung |
|---|---|
|
Die Konfigurationsdaten sind beschädigt. |
|
Ein ungültiger Parameter wurde an die Funktion übergeben. |
|
Es gibt keine Komponenten, die zurückgegeben werden sollen. |
|
Das System verfügt nicht über genügend Arbeitsspeicher, um den Vorgang abzuschließen. Verfügbar mit Windows Server 2003. |
|
Ein Wert wurde aufgezählt. |
Bemerkungen
Um Komponenten aufzählen zu können, sollte eine Anwendung zunächst die MsiEnumComponents-Funktion mit dem Parameter "iComponentIndex " auf Null aufrufen. Die Anwendung sollte dann den iComponentIndex-Parameter inkrementieren und MsiEnumComponents aufrufen, bis keine weiteren Komponenten vorhanden sind (das heißt, bis die Funktion ERROR_NO_MORE_ITEMS zurückgibt).
Wenn Sie mehrere Anrufe an MsiEnumComponents tätigen, um alle Komponenten des Produkts aufzählen zu können, sollte jeder Aufruf aus demselben Thread vorgenommen werden.
Hinweis
Der msi.h-Header definiert MsiEnumComponents als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstanten automatisch auswählt. Das Mischen der Verwendung des Codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann dazu führen, dass keine Übereinstimmungen auftreten, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Installer 5.0 auf 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. Weitere Informationen zu dem mindesten Windows-Service pack, das von einer Windows Installer-Version benötigt wird, finden Sie unter den Windows Installer-Run-Time Anforderungen. |
| Zielplattform | Windows |
| Kopfzeile | msi.h |
| Bibliothek | Msi.lib |
| DLL | Msi.dll |