MsiViewGetErrorW-Funktion (msiquery.h)
Die MsiViewGetError-Funktion gibt den Fehler zurück, der in der MsiViewModify-Funktion aufgetreten ist.
Syntax
MSIDBERROR MsiViewGetErrorW(
[in] MSIHANDLE hView,
[out] LPWSTR szColumnNameBuffer,
[in, out] LPDWORD pcchBuf
);
Parameter
[in] hView
Handle mit der Ansicht.
[out] szColumnNameBuffer
Zeiger auf den Puffer, der den null-beendeten Spaltennamen empfängt. Versuchen Sie nicht, die Größe des Puffers zu bestimmen, indem Sie null (value=0) für szColumnName übergeben. Sie können die Größe des Puffers abrufen, indem Sie eine leere Zeichenfolge übergeben (z. B. "). Die Funktion gibt dann MSIDBERROR_MOREDATA zurück, und pcchBuf enthält die erforderliche Puffergröße in TCHARs, ohne das beendende NULL-Zeichen. Bei Rückgabe von MSIDBERROR_NOERROR enthält pcchBuf die Anzahl der TCHARs, die in den Puffer geschrieben wurden, ohne das beendende NULL-Zeichen. Dieser Parameter ist eine leere Zeichenfolge, wenn keine Fehler vorliegen.
[in, out] pcchBuf
Zeiger auf die Variable, die in TCHARs die Größe des Puffers angibt, auf den die Variable szColumnNameBuffer verweist. Wenn die Funktion MSIDBERROR_NOERROR zurückgibt, enthält diese Variable die Größe der in szColumnNameBuffer kopierten Daten, ohne das beendende NULL-Zeichen. Wenn szColumnNameBuffer nicht groß genug ist, gibt die Funktion MSIDBERROR_MOREDATA zurück und speichert die erforderliche Größe ohne das beendende NULL-Zeichen in der Variablen, auf die von pcchBuf verwiesen wird.
Rückgabewert
Diese Funktion gibt einen der folgenden Werte zurück.
| Fehlercode | Bedeutung |
|---|---|
|
Ein Argument war ungültig. |
|
Der Puffer war zu klein, um Daten zu empfangen. |
|
Fehler bei der Funktion. |
|
Die Funktion wurde ohne Fehler erfolgreich abgeschlossen. |
|
Der neue Datensatz dupliziert Primärschlüssel des vorhandenen Datensatzes in einer Tabelle. |
|
Es sind keine NULL-Werte zulässig. oder die Spalte wird gerade gelöscht, wird aber von einer anderen Zeile referenziert. |
|
Der entsprechende Datensatz in einer fremden Tabelle wurde nicht gefunden. |
|
Die Daten sind größer als der zulässige Maximalwert. |
|
Die Daten sind kleiner als der zulässige Mindestwert. |
|
Die Daten sind kein Element der im Satz zulässigen Werte. |
|
Eine ungültige Versionszeichenfolge wurde angegeben. |
|
Der Fall war ungültig. Der Groß- oder Kleinbuchstaben muss ganz groß sein. |
|
Eine ungültige GUID wurde angegeben. |
|
Ein ungültiger Feldhalterdateiname wurde angegeben, oder die Verwendung von Feldhaltern war ungültig. |
|
Ein ungültiger Bezeichner wurde angegeben. |
|
Es wurden ungültige Sprach-IDs angegeben. |
|
Ein ungültiger Dateiname wurde angegeben. |
|
Ein ungültiger Pfad wurde angegeben. |
|
Eine ungültige bedingte Anweisung wurde angegeben. |
|
Es wurde eine ungültige Formatzeichenfolge angegeben. |
|
Eine ungültige Vorlagenzeichenfolge wurde angegeben. |
|
Eine ungültige Zeichenfolge wurde in der DefaultDir-Spalte der Directory-Tabelle angegeben. |
|
Es wurde eine ungültige Registrierungspfadzeichenfolge angegeben. |
|
In der CustomSource-Spalte der CustomAction-Tabelle wurde eine ungültige Zeichenfolge angegeben. |
|
Eine ungültige Eigenschaftszeichenfolge wurde angegeben. |
|
Der _Validation Tabelle fehlt ein Verweis auf eine Spalte. |
|
Die Kategoriespalte der _Validation Tabelle für die Spalte ist ungültig. |
|
Ein ungültiger Ablagename wurde angegeben. |
|
Die Tabelle in der Spalte Keytable der _Validation Tabelle wurde nicht gefunden oder geladen. |
|
Der Wert in der MaxValue-Spalte der _Validation Tabelle ist kleiner als der Wert in der MinValue-Spalte. |
|
Ein ungültiger Verknüpfungszielname wurde angegeben. |
|
Die Zeichenfolge ist für die von der Spaltendefinition angegebene Länge zu lang. |
|
Ein ungültiges Lokalisierungsattribut wurde angegeben. (Primärschlüssel können nicht lokalisiert werden.) |
Beachten Sie, dass diese Funktion in Situationen mit wenig Arbeitsspeicher eine STATUS_NO_MEMORY Ausnahme auslösen kann.
Hinweise
Sie sollten die MsiViewGetError-Funktion nur aufrufen, wenn MsiViewModify ERROR_INVALID_DATA zurückgibt, was angibt, dass die Daten ungültig sind. Fehler werden nur für MSIMODIFY_VALIDATE, MSIMODIFY_VALIDATE_NEW und MSIMODIFY_VALIDATEFIELD aufgezeichnet.
Wenn ERROR_MORE_DATA zurückgegeben wird, gibt der Parameter, der ein Zeiger ist, die Größe des Puffers an, der zum Halten der Zeichenfolge erforderlich ist. Bei Erfolg wird die Anzahl der Zeichen angegeben, die in den Zeichenfolgenpuffer geschrieben werden. Daher können Sie die erforderliche Größe des Puffers abrufen, indem Sie einen kleinen Puffer (mindestens ein Zeichen) übergeben und den Wert bei pcchPathBuf untersuchen, wenn die Funktion MSIDBERROR_MOREDATA zurückgibt. Versuchen Sie nicht, die Größe des Puffers zu bestimmen, indem Sie null als szColumnNameBuffer oder eine Puffergröße von 0 im DWORD übergeben, auf das von pcchBuf verwiesen wird.
Sobald MSIDBERROR_NOERROR zurückgegeben wurde, bleiben keine Weiteren Validierungsfehler mehr erhalten. Der MSIDBERROR-Rückgabewert gibt den Typ des Validierungsfehlers an, der sich für den Wert in der Spalte befindet, die vom szColumnNameBuffer identifiziert wurde.
Hinweis
Der msiquery.h-Header definiert MsiViewGetError 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 nicht codierungsneutralem Code 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
Übergeben von Null als Argument von Windows Installer-Funktionen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für