IMsmError::get_Type-Methode (mergemod.h)
Die get_Type-Methode ruft die Type-Eigenschaft des Error-Objekts ab. Diese Methode gibt einen msmErrorType-Wert zurück, der den Fehlertyp angibt, der von diesem Objekt dargestellt wird.
Syntax
HRESULT get_Type(
[out] msmErrorType *ErrorType
);
Parameter
[out] ErrorType
Ein Zeiger auf einen Speicherort im Arbeitsspeicher, der den Typ des Fehlers empfängt.
| msmErrorType | Wert | Beschreibung |
|---|---|---|
| msmErrorLanguageUnsupported | 1 | Es wurde eine Anforderung zum Öffnen eines Moduls mit einer Sprache gestellt, die vom Modul nicht unterstützt wird. Vom Modul wird keine allgemeine Sprache mehr unterstützt. Fügt msmErrorLanguageUnsupported der Type-Eigenschaft und der angeforderten Sprache der Language-Eigenschaft (Error Object) hinzu. Alle Error-Objekteigenschaften sind leer. Die OpenModule-Funktion gibt ERROR_INSTALL_LANGUAGE_UNSUPPORTED (als HRESULT) zurück. |
| msmErrorLanguageFailed | 2 | Es wurde eine Anforderung zum Öffnen eines Moduls mit einer unterstützten Sprache gestellt, aber das Modul verfügt über eine ungültige Sprachtransformation. Fügt msmErrorLanguageFailed der Type-Eigenschaft und der Sprache der angewendeten Transformation zur Language-Eigenschaft des Error-Objekts hinzu. Dies ist möglicherweise nicht die angeforderte Sprache, wenn eine allgemeinere Sprache verwendet wurde. Alle anderen Eigenschaften des Error-Objekts sind leer. Die OpenModule-Funktion gibt ERROR_INSTALL_LANGUAGE_UNSUPPORTED (als HRESULT) zurück. |
| msmErrorExclusion | 3 | Das Modul kann nicht zusammengeführt werden, da es ein anderes Modul in der Datenbank ausschließt oder von ausgeschlossen wird. Fügt msmErrorExclusion der Type-Eigenschaft des Error-Objekts hinzu. Die ModuleKeys-Eigenschaft oder DatabaseKeys-Eigenschaft enthält die Primärschlüssel der Zeile des ausgeschlossenen Moduls in der Tabelle ModuleExclusion. Wenn ein vorhandenes Modul das zusammengeführte Modul ausschließt, werden die ModuleSignature-Informationen des ausgeschlossenen Moduls Zu ModuleKeys hinzugefügt. Wenn das zusammengeführte Modul ein vorhandenes Modul ausschließt, enthält DatabaseKeys die ModuleSignature-Informationen des ausgeschlossenen Moduls. Alle anderen Eigenschaften sind leer (oder -1). |
| msmErrorTableMerge | 4 | Mergekonflikt beim Zusammenführen. Der Wert der Type-Eigenschaft ist auf msmErrorTableMerge festgelegt. Die DatabaseTable-Eigenschaft und die DatabaseKeys-Eigenschaft enthalten den Tabellennamen und die Primärschlüssel der in Konflikt stehenden Zeile in der Datenbank. Die ModuleTable-Eigenschaft und die ModuleKeys-Eigenschaft enthalten den Tabellennamen und die Primärschlüssel der konfliktierenden Zeile im Modul. Die Einträge ModuleTable und ModuleKeys können NULL sein, wenn die Zeile in der Datenbank nicht vorhanden ist. Beispielsweise, wenn der Konflikt in einem generierten FeatureComponents-Tabelleneintrag vorliegt. Beim Zusammenführen eines konfigurierbaren Mergemoduls kann die Konfiguration dazu führen, dass diese Eigenschaften auf Zeilen verweisen, die im Modul nicht vorhanden sind. |
| msmErrorResequenceMerge | 5 | Es ist ein Problem aufgetreten, eine Sequenztabelle erneut zu verwenden, um die erforderlichen zusammengeführten Aktionen zu enthalten. Die Type-Eigenschaft ist auf msmErrorResequenceMerge festgelegt. Die DatabaseTable- und DatabaseKeys-Eigenschaften enthalten den Namen der Sequenztabelle und die Primärschlüssel (Aktionsname) der in Konflikt stehenden Zeile. Die Eigenschaften ModuleTable und ModuleKeys enthalten den Namen der Sequenztabelle und den Primärschlüssel (Aktionsname) der konfliktierenden Zeile. Beim Zusammenführen eines konfigurierbaren Mergemoduls kann die Konfiguration dazu führen, dass diese Eigenschaften auf Zeilen verweisen, die im Modul nicht vorhanden sind. |
| msmErrorFileCreate | 6 | Wird nicht verwendet. |
| msmErrorDirCreate | 7 | Es gab ein Problem beim Erstellen eines Verzeichnisses zum Extrahieren einer Datei auf den Datenträger. Die Path-Eigenschaft enthält das Verzeichnis, das nicht erstellt werden konnte. Alle anderen Eigenschaften sind leer oder -1. |
| msmErrorFeatureRequired | 8 | Ein Featurename ist erforderlich, um die Zusammenführung abzuschließen, aber es wurde kein Featurename angegeben. Die Type-Eigenschaft ist auf msmErrorFeatureRequired festgelegt. DatabaseTable und DatabaseKeys enthalten den Tabellennamen und die Primärschlüssel der konfliktierenden Zeile. Die ModuleTable- und ModuleKeys-Eigenschaften enthalten den Tabellennamen und die Primärschlüssel der Zeile können nicht zusammengeführt werden. Beim Zusammenführen eines konfigurierbaren Mergemoduls kann die Konfiguration dazu führen, dass diese Eigenschaften auf Zeilen verweisen, die im Modul nicht vorhanden sind. Wenn der Fehler in einer generierten FeatureComponents-Tabelle auftritt, sind die Eigenschaften DatabaseTable und DatabaseKeys leer, und die Eigenschaften ModuleTable und ModuleKeys verweisen auf die Zeile in der Tabelle Component , die den Fehler verursacht. |
| msmErrorBadNullSubstitution | 9 | Ersetzung eines Null-Werts in eine Spalte ohne Nullable. Dadurch wird msmErrorBadNullSubstitution in die Type-Eigenschaft eingegeben und "ModuleSubstitution" und die Schlüssel aus der ModuleSubstitution-Tabelle für diese Zeile in die ModuleTable-Eigenschaft und die ModuleKeys-Eigenschaft eingegeben. Alle anderen Eigenschaften des Error-Objekts sind auf eine leere Zeichenfolge oder -1 festgelegt.
Dieser Fehler führt dazu, dass die Mergefunktion und die MergeEx-Funktion sofort E_FAIL zurückgeben. |
| msmErrorBadSubstitutionType | 10 | Ersetzung des Textformattyps oder des Ganzzahlformattyps in eine Binärtyp-Datenspalte . Dieser Fehlertyp gibt msmErrorBadSubstitutionType in der Type-Eigenschaft zurück und gibt "ModuleSubstitution" und die Schlüssel aus der ModuleSubstitution-Tabelle für diese Zeile in die ModuleTable-Eigenschaft ein. Alle anderen Eigenschaften des Error-Objekts sind auf eine leere Zeichenfolge oder -1 festgelegt.
Dieser Fehler führt dazu, dass die Mergefunktion und die MergeEx-Funktion sofort E_FAIL zurückgeben. |
| msmErrorMissingConfigItem | 11 | Eine Zeile in der Tabelle ModuleSubstitution verweist auf ein Konfigurationselement, das in der Tabelle ModuleConfiguration nicht definiert ist. Dieser Fehlertyp gibt msmErrorMissingConfigItem in der Type-Eigenschaft zurück und gibt "ModuleSubstitution" und die Schlüssel aus der ModuleSubstitution-Tabelle für diese Zeile in die ModuleTable-Eigenschaft ein. Alle anderen Eigenschaften des Error-Objekts sind auf eine leere Zeichenfolge oder -1 festgelegt.
Dieser Fehler führt dazu, dass die Mergefunktion und die MergeEx-Funktion sofort E_FAIL zurückgeben. |
| msmErrorBadNullResponse | 12 | Das Erstellungstool hat einen Null-Wert für ein Element zurückgegeben, das mit dem Attribut msmConfigItemNonNullable gekennzeichnet ist. Ein Fehler dieses Typs gibt msmErrorBadNullResponse in der Type-Eigenschaft zurück und gibt "ModuleSubstitution" und die Schlüssel aus der ModuleSubstitution-Tabelle für das Element in die ModuleTable-Eigenschaft ein. Alle anderen Eigenschaften des Error-Objekts sind auf eine leere Zeichenfolge oder -1 festgelegt.
Dieser Fehler führt dazu, dass die Mergefunktion und die MergeEx-Funktion sofort E_FAIL zurückgeben. |
| msmErrorDataRequestFailed | 13 | Das Erstellungstool hat einen Fehlercode (nicht S_OK oder S_FALSE) zurückgegeben, wenn er nach Daten gefragt wurde. Ein Fehler dieses Typs gibt msmErrorDataRequestFailed in der Type-Eigenschaft zurück und gibt "ModuleSubstitution" und die Schlüssel aus der ModuleSubstitution-Tabelle für das Element in die ModuleTable-Eigenschaft ein. Alle anderen Eigenschaften des Error-Objekts sind auf eine leere Zeichenfolge oder -1 festgelegt.
Dieser Fehler führt dazu, dass die Mergefunktion und die MergeEx-Funktion sofort E_FAIL zurückgeben. |
| msmErrorPlatformMismatch | 14 | Gibt an, dass versucht wurde, ein 64-Bit-Modul in einem Paket zusammenzuführen, das kein 64-Bit-Paket war. Ein Fehler dieses Typs gibt msmErrorPlatformMismatch in der Type-Eigenschaft zurück. Alle anderen Eigenschaften des Fehlerobjekts sind auf eine leere Zeichenfolge oder -1 festgelegt. Dieser Fehler verursacht den sofortigen Fehler des Merges und bewirkt, dass die Merge - oder MergeEx-Funktion E_FAIL zurückgibt. |
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Wert | Bedeutung |
|---|---|
|
ErrorType ist NULL. |
|
Die Funktion wurde erfolgreich ausgeführt. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Mergemod.dll 2.0 oder höher |
| Zielplattform | Windows |
| Kopfzeile | mergemod.h |
| DLL | Mergemod.dll |