Metodo IMsmError::get_Type (mergemod.h)
Il metodo get_Type recupera la proprietà Type dell'oggetto Error . Questo metodo restituisce un valore msmErrorType che indica il tipo di errore rappresentato da questo oggetto.
Sintassi
HRESULT get_Type(
[out] msmErrorType *ErrorType
);
Parametri
[out] ErrorType
Puntatore a una posizione in memoria che riceve il tipo di errore.
| msmErrorType | Valore | Descrizione |
|---|---|---|
| msmErrorLanguageUnsupported | 1 | È stata effettuata una richiesta per aprire un modulo con una lingua non supportata dal modulo. Nessun linguaggio più generale è supportato dal modulo. Aggiunge msmErrorLanguageUnsupported alla proprietà Type e alla lingua richiesta alla proprietà Language (oggetto Error). Tutte le proprietà dell'oggetto Error sono vuote. La funzione OpenModule restituisce ERROR_INSTALL_LANGUAGE_UNSUPPORTED (come HRESULT). |
| msmErrorLanguageFailed | 2 | È stata effettuata una richiesta per aprire un modulo con una lingua supportata, ma il modulo ha una trasformazione del linguaggio non valida. Aggiunge msmErrorLanguageFailed alla proprietà Type e alla lingua della trasformazione applicata alla proprietà Language dell'oggetto Error . Potrebbe non trattarsi della lingua richiesta se è stata usata una lingua più generale. Tutte le altre proprietà dell'oggetto Error sono vuote. La funzione OpenModule restituisce ERROR_INSTALL_LANGUAGE_UNSUPPORTED (come HRESULT). |
| msmErrorExclusion | 3 | Il modulo non può essere unito perché esclude o è escluso da un altro modulo nel database. Aggiunge msmErrorExclusion alla proprietà Type dell'oggetto Error . La proprietà ModuleKeys o DatabaseKeys contiene le chiavi primarie della riga del modulo escluso nella tabella ModuleExclusion. Se un modulo esistente esclude il modulo da unire, le informazioni ModuleSignature del modulo escluse vengono aggiunte a ModuleKeys. Se il modulo da unire esclude un modulo esistente, DatabaseKeys contiene le informazioni ModuleSignature del modulo escluse. Tutte le altre proprietà sono vuote (o -1). |
| msmErrorTableMerge | 4 | Conflitto di merge durante l'unione. Il valore della proprietà Type è impostato su msmErrorTableMerge. La proprietà DatabaseTable e La proprietàDatabaseKeys contengono il nome della tabella e le chiavi primarie della riga in conflitto nel database. La proprietà ModuleTable e la proprietà ModuleKeys contengono il nome della tabella e le chiavi primarie della riga in conflitto nel modulo. Le voci ModuleTable e ModuleKeys possono essere Null se la riga non esiste nel database. Ad esempio, se il conflitto si trova in una voce di tabella FeatureComponents generata. Quando si uniscono un modulo di merge configurabile, la configurazione può causare il riferimento a righe che non esistono nel modulo. |
| msmErrorResequenceMerge | 5 | Si è verificato un problema durante la sequenza di una tabella di sequenza per contenere le azioni unite necessarie. La proprietà Type è impostata su msmErrorResequenceMerge. Le proprietà DatabaseTable e DatabaseKeys contengono il nome della tabella di sequenza e le chiavi primarie (nome azione) della riga in conflitto. Le proprietà ModuleTable e ModuleKeys contengono il nome della tabella di sequenza e la chiave primaria (nome azione) della riga in conflitto. Quando si uniscono un modulo di merge configurabile, la configurazione può causare il riferimento a righe che non esistono nel modulo. |
| msmErrorFileCreate | 6 | Non usato. |
| msmErrorDirCreate | 7 | Si è verificato un problema durante la creazione di una directory per estrarre un file su disco. La proprietà Path contiene la directory che non è stato possibile creare. Tutte le altre proprietà sono vuote o -1. |
| msmErrorFeatureRequired | 8 | Per completare l'unione è necessario un nome di funzionalità, ma non è stato specificato alcun nome di funzionalità. La proprietà Type è impostata su msmErrorFeatureRequired. DatabaseTable e DatabaseKeys contengono il nome della tabella e le chiavi primarie della riga in conflitto. Le proprietà ModuleTable e ModuleKeys contengono il nome della tabella e le chiavi primarie della riga non possono essere unite. Quando si uniscono un modulo di merge configurabile, la configurazione può causare il riferimento a righe che non esistono nel modulo. Se l'errore si trova in una tabella FeatureComponents generata, le proprietà DatabaseTable e DatabaseKeys sono vuote e le proprietà ModuleTable e ModuleKeys fanno riferimento alla riga nella tabella Component che causa l'errore. |
| msmErrorBadNullSubstitution | 9 | Sostituzione di un valore Null in una colonna non nullable. Viene immesso msmErrorBadNullSubstitution nella proprietà Type e immette "ModuleSubstitution" e le chiavi della tabella ModuleSubstitution per questa riga nella proprietà ModuleTable e nella proprietà ModuleKeys . Tutte le altre proprietà dell'oggetto Error vengono impostate su una stringa vuota o su -1.
Questo errore causa l'errore immediato dell'unione e della funzioneMergeEx per restituire E_FAIL. |
| msmErrorBadSubstitutionType | 10 | Sostituzione del tipo di formato testo o del tipo di formato integer in una colonna di dati Tipo binario . Questo tipo di errore restituisce msmErrorBadSubstitutionType nella proprietà Type e immette "ModuleSubstitution" e le chiavi della tabella ModuleSubstitution per questa riga nella proprietà ModuleTable . Tutte le altre proprietà dell'oggetto Error vengono impostate su una stringa vuota o su -1.
Questo errore causa l'errore immediato dell'unione e della funzioneMergeEx per restituire E_FAIL. |
| msmErrorMissingConfigItem | 11 | Una riga nella tabella ModuleSubstitution fa riferimento a un elemento di configurazione non definito nella tabella ModuleConfiguration. Questo tipo di errore restituisce msmErrorMissingConfigItem nella proprietà Type e immette "ModuleSubstitution" e le chiavi della tabella ModuleSubstitution per questa riga nella proprietà ModuleTable . Tutte le altre proprietà dell'oggetto Error vengono impostate su una stringa vuota o su -1.
Questo errore causa l'errore immediato dell'unione e della funzioneMergeEx per restituire E_FAIL. |
| msmErrorBadNullResponse | 12 | Lo strumento di creazione ha restituito un valore Null per un elemento contrassegnato con l'attributo msmConfigItemNonNullable. Un errore di questo tipo restituisce msmErrorBadNullResponse nella proprietà Type e immette "ModuleSubstitution" e le chiavi della tabella ModuleSubstitution per l'elemento nella proprietà ModuleTable . Tutte le altre proprietà dell'oggetto Error vengono impostate su una stringa vuota o su -1.
Questo errore causa l'errore immediato dell'unione e della funzioneMergeEx per restituire E_FAIL. |
| msmErrorDataRequestFailed | 13 | Lo strumento di creazione ha restituito un codice di errore (non S_OK o S_FALSE) quando vengono richiesti dati. Un errore di questo tipo restituirà msmErrorDataRequestFailed nella proprietà Type e immette "ModuleSubstitution" e le chiavi della tabella ModuleSubstitution per l'elemento nella proprietà ModuleTable . Tutte le altre proprietà dell'oggetto Error vengono impostate su una stringa vuota o su -1.
Questo errore causa l'errore immediato dell'unione e della funzioneMergeEx per restituire E_FAIL. |
| msmErrorPlatformMismatch | 14 | Indica che è stato effettuato un tentativo di unire un modulo a 64 bit in un pacchetto che non era un pacchetto a 64 bit. Un errore di questo tipo restituisce msmErrorPlatformMismatch nella proprietà Type . Tutte le altre proprietà dell'oggetto errore vengono impostate su una stringa vuota o su -1. Questo errore causa l'errore immediato dell'unione e fa sì che la funzione Merge o MergeEx restituisca E_FAIL. |
Valore restituito
Questo metodo può restituire uno di questi valori.
| Valore | Significato |
|---|---|
|
ErrorType è Null. |
|
Funzione completata. |
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Mergemod.dll 2.0 o versione successiva |
| Piattaforma di destinazione | Windows |
| Intestazione | mergemod.h |
| DLL | Mergemod.dll |