MsiDatabaseGetPrimaryKeysA-Funktion (msiquery.h)

  • Artikel

Die MsiDatabaseGetPrimaryKeys-Funktion gibt einen Datensatz zurück, der die Namen aller Primärschlüsselspalten für eine angegebene Tabelle enthält. Diese Funktion gibt ein Handle zurück, das mit MsiCloseHandle geschlossen werden soll.

Syntax

UINT MsiDatabaseGetPrimaryKeysA(
  [in]  MSIHANDLE hDatabase,
  [in]  LPCSTR    szTableName,
  [out] MSIHANDLE *phRecord
);

Parameter

[in] hDatabase

Handle für die Datenbank. Weitere Informationen finden Sie unter Abrufen eines Datenbankhandles.

[in] szTableName

Gibt den Namen der Tabelle an, aus der Primärschlüsselnamen abgerufen werden sollen.

[out] phRecord

Zeiger auf das Handle des Datensatzes, der die Primärschlüsselnamen enthält.

Rückgabewert

Diese Funktion gibt UINT zurück.

Hinweise

Die Feldanzahl des zurückgegebenen Datensatzes ist die Anzahl der Primärschlüsselspalten, die von der MsiDatabaseGetPrimaryKeys-Funktion zurückgegeben werden. Der zurückgegebene Datensatz enthält den Tabellennamen in Feld (0) und die Spaltennamen, aus denen die Primärschlüsselnamen in nachfolgenden Feldern bestehen. Diese Primärschlüsselnamen entsprechen den Spaltennummern für die Felder.

Diese Funktion kann nicht mit der _Tables-Tabelle oder der _Columns-Tabelle verwendet werden.

Beachten Sie, dass die Verwendung von Variablen vom Typ PMSIHANDLE empfohlen wird, da das Installationsprogramm PMSIHANDLE-Objekte schließt, wenn sie den Gültigkeitsbereich sprengen, während Sie MSIHANDLE-Objekte durch Aufrufen von MsiCloseHandle schließen müssen. Weitere Informationen finden Sie im Abschnitt Verwenden von PMSIHANDLE anstelle von HANDLE im Abschnitt Bewährte Methoden für Windows Installer.

Hinweis

Der msiquery.h-Header definiert MsiDatabaseGetPrimaryKeys 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

Allgemeine Datenbankzugriffsfunktionen