MsiOpenPackageExA-Funktion (msi.h)

Die MsiOpenPackageEx-Funktion öffnet ein Paket, das mit Funktionen verwendet werden kann, die auf die Produktdatenbank zugreifen. Die MsiCloseHandle-Funktion muss mit dem Handle aufgerufen werden, wenn das Handle nicht mehr benötigt wird.

Syntax

UINT MsiOpenPackageExA(
  [in]  LPCSTR    szPackagePath,
  [in]  DWORD     dwOptions,
  [out] MSIHANDLE *hProduct
);

Parameter

[in] szPackagePath

Der Pfad zum Paket.

[in] dwOptions

Die Bitflags, um anzugeben, ob der Computerzustand ignoriert werden soll. Übergeben Sie 0 (null), um das MsiOpenPackage-Verhalten zu verwenden.

[out] hProduct

Ein Zeiger auf eine Variable, die das Produkthandle empfängt.

Rückgabewert

Wenn diese Funktion fehlschlägt, gibt sie möglicherweise einen Systemfehlercode zurück. Weitere Informationen finden Sie unter Systemfehlercodes.

Hinweise

Um ein eingeschränktes Produkthandle zu erstellen, das unabhängig vom aktuellen Computerstatus ist und nicht in der Lage ist, den aktuellen Computerstatus zu ändern, verwenden Sie MsiOpenPackageEx mit MSIOPENPACKAGEFLAGS_IGNOREMACHINESTATE in dwOptions festgelegt.

Beachten Sie, dass msiOpenPackageEx beim Erstellen des Produkthandles den aktuellen Computerstatus ignoriert, wenn dwOptions MSIOPENPACKAGEFLAGS_IGNOREMACHINESTATE oder 1 ist. Wenn der Wert von dwOptions 0 ist, ist MsiOpenPackageEx identisch mit MsiOpenPackage und erstellt ein Produkthandle, das davon abhängig ist, ob das von szPackagePath angegebene Paket bereits auf dem Computer installiert ist.

Das eingeschränkte Handle, das mithilfe von MsiOpenPackageEx mit MSIOPENPACKAGEFLAGS_IGNOREMACHINESTATE erstellt wurde, ermöglicht nur die Ausführung von Dialogfeldern, einer Teilmenge der Standardaktionen und benutzerdefinierten Aktionen, die Eigenschaften festlegen ( Benutzerdefinierter Aktionstyp 35, Benutzerdefinierter Aktionstyp 51 und Benutzerdefinierter Aktionstyp 19). Das eingeschränkte Handle verhindert die Verwendung benutzerdefinierter Aktionen, die Dynamic-Link-Bibliotheken, ausführbare Dateien oder Skripts ausführen.

Sie können MsiDoAction für die folgenden Standardaktionen mit dem eingeschränkten Handle aufrufen. Alle anderen Aktionen geben ERROR_FUNCTION_NOT_CALLED zurück, wenn sie mit dem eingeschränkten Handle aufgerufen werden.

• ADMIN
• ADVERTISE
• INSTALL
• SEQUENCE
• AppSearch-Aktion
• CCPSearch
• CostFinalize
• CostInitialize
• FileCost
• FindRelatedProducts
• IsolateComponents-Aktion
• LaunchConditions
• MigrateFeatureStates
• ResolveSource
• RMCCPSearch
• ValidateProductID

Anforderungen