MsiDetermineApplicablePatchesA-Funktion (msi.h)
Die MsiDetermineApplicablePatches-Funktion akzeptiert eine Reihe von Patchdateien, XML-Dateien und XML-Blobs und bestimmt, welche Patches auf ein angegebenes Windows Installer-Paket angewendet werden und in welcher Reihenfolge. Die Funktion kann abgelöste oder veraltete Patches berücksichtigen. Diese Funktion berücksichtigt keine Produkte oder Patches, die auf dem System installiert und nicht in der Gruppe angegeben sind.
Syntax
UINT MsiDetermineApplicablePatchesA(
[in] LPCSTR szProductPackagePath,
[in] DWORD cPatchInfo,
[in] PMSIPATCHSEQUENCEINFOA pPatchInfo
);
Parameter
[in] szProductPackagePath
Vollständiger Pfad zu einer .msi-Datei. Die Funktion bestimmt die Patches, die für dieses Paket gelten, und in welcher Reihenfolge.
[in] cPatchInfo
Anzahl der Patches im Array. Muss größer sein als Null.
[in] pPatchInfo
Zeiger auf ein Array von MSIPATCHSEQUENCEINFO-Strukturen .
Rückgabewert
Die MsiDetermineApplicablePatches-Funktion gibt die folgenden Werte zurück.
| Wert | Bedeutung |
|---|---|
|
Die Funktion ist in einer Weise fehlgeschlagen, die in den anderen Fehlercodes nicht abgedeckt ist. |
|
Ein Argument ist ungültig. |
|
Für den Satz von Patches wurde keine gültige Sequenz gefunden. |
|
Die Patches wurden erfolgreich sortiert. |
|
Die .msi Datei wurde nicht gefunden. |
|
Der Pfad zur .msi Datei wurde nicht gefunden. |
|
Die XML-Patchdaten sind ungültig. |
|
Ein Installationspaket, auf das durch pfad verwiesen wird, kann nicht geöffnet werden. |
|
Dieser Fehler kann zurückgegeben werden, wenn die Funktion von einer benutzerdefinierten Aktion aufgerufen wurde oder WENN MSXML 3.0 nicht installiert ist. |
Hinweise
Wenn diese Funktion von einer benutzerdefinierten Aktion aufgerufen wird, schlägt sie fehl und gibt ERROR_CALL_NOT_IMPLEMENTED zurück. Die Funktion erfordert MSXML Version 3.0 zum Verarbeiten von XML und gibt ERROR_CALL_NOT_IMPLEMENTED zurück, wenn MSXML 3.0 nicht installiert ist.
Die MsiDetermineApplicablePatches-Funktion legt die Elemente uStatus und dwOrder jeder MSIPATCHSEQUENCEINFO-Struktur fest, auf die von pPatchInfo verwiesen wird. Jede Struktur enthält Informationen zu einem bestimmten Patch.
Wenn die Funktion erfolgreich ist, gibt die MSIPATCHSEQUENCEINFO-Struktur jedes Patchs, der auf das Produkt angewendet werden kann, mit einem uStatus von ERROR_SUCCESS und einem dwOrder-Wert zurück, der größer oder gleich 0 ist. Die Werte von dwOrder größer oder gleich 0 geben die beste Anwendungssequenz für die Patches an, die mit 0 beginnen.
Wenn die Funktion erfolgreich ist, geben Patches, die von der besten Patchsequenz ausgeschlossen sind, eine MSIPATCHSEQUENCEINFO-Struktur mit einem dwOrder-Wert von -1 zurück. In diesen Fällen weist das Feld uStatus ERROR_SUCCESS auf einen Patch hin, der für das Produkt veraltet oder abgelöst ist. Ein uStatus-Feld mit ERROR_PATCH_TARGET_NOT_FOUND gibt einen Patch an, der für das Produkt nicht angewendet werden kann.
Wenn die Funktion fehlschlägt, gibt die MSIPATCHSEQUENCEINFO-Struktur für jeden Patch einen dwOrder-Wert von -1 zurück. In diesem Fall können die uStatus-Felder Fehler mit weiteren Informationen zu einzelnen Patches enthalten. Beispielsweise wird ERROR_PATCH_NO_SEQUENCE für Patches zurückgegeben, die zirkuläre Sequenzierungsinformationen enthalten.
Hinweis
Der msi.h-Header definiert MsiDetermineApplicablePatches 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
| Unterstützte Mindestversion (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 3.0 oder höher unter Windows Server 2003 oder Windows XP. Informationen zum mindestens erforderlichen Windows Service Pack für eine Windows Installer-Version finden Sie unter Windows Installer – Laufzeitanforderungen. |
| Zielplattform | Windows |
| Kopfzeile | msi.h |
| Bibliothek | Msi.lib |
| DLL | Msi.dll |