MsiDatabaseExportA-Funktion (msiquery.h)

  • Artikel

Die MsiDatabaseExport-Funktion exportiert eine Microsoft Installer-Tabelle aus einer geöffneten Datenbank in eine Textarchivdatei.

Syntax

UINT MsiDatabaseExportA(
  [in] MSIHANDLE hDatabase,
  [in] LPCSTR    szTableName,
  [in] LPCSTR    szFolderPath,
  [in] LPCSTR    szFileName
);

Parameter

[in] hDatabase

Das Handle für eine Datenbank aus MsiOpenDatabase.

[in] szTableName

Der Name der zu exportierenden Tabelle.

[in] szFolderPath

Der Name des Ordners, der Archivdateien enthält.

[in] szFileName

Der Name der exportierten Tabellenarchivdatei.

Rückgabewert

Die MsiDatabaseExport-Funktion gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
ERROR_BAD_PATHNAME
 Ein ungültiger Pfad wird an die Funktion übergeben.
ERROR_FUNCTION_FAILED
 Die Funktion schlägt fehl.
ERROR_INVALID_HANDLE
 Ein ungültiges oder inaktives Handle wird bereitgestellt.
ERROR_INVALID_PARAMETER
 Ein ungültiger Parameter wird an die Funktion übergeben.
ERROR_SUCCESS
 Die Funktion ist erfolgreich.

Hinweise

Wenn eine Tabelle Streams enthält, exportiert MsiDatabaseExport jeden Stream in eine separate Datei.

Weitere Informationen finden Sie unter MsiDatabaseImport.

Diese Funktion kann nicht über benutzerdefinierte Aktionen aufgerufen werden. Ein Aufruf dieser Funktion aus einer benutzerdefinierten Aktion führt dazu, dass die Funktion fehlschlägt.

Wenn die Funktion fehlschlägt, können Sie erweiterte Fehlerinformationen mithilfe von MsiGetLastErrorRecord abrufen.

Hinweis

Der msiquery.h-Header definiert MsiDatabaseExport 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
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 unter Windows Server 2003 oder Windows XP
Zielplattform Windows
Kopfzeile msiquery.h
Bibliothek Msi.lib
DLL Msi.dll

Weitere Informationen

Datenbankverwaltungsfunktionen

Textarchivdateien