Metodo IMsmMerge::Merge (mergemod.h)
Il metodo Merge esegue un'unione del database corrente e del modulo corrente. L'unione collega i componenti del modulo alla funzionalità identificata da Feature. La radice dell'albero di directory del modulo viene reindirizzata alla posizione specificata da RedirectDir. Per altre informazioni, vedere il metodo Merge dell'oggetto Merge .
IMsmMerge2::Merge Mergemod.dll versione 2.0 o successiva.
Sintassi
HRESULT Merge(
[in] const BSTR Feature,
[in] const BSTR RedirectDir
);
Parametri
[in] Feature
Nome di una funzionalità nel database. Un LPCWSTR può essere usato al posto di un BSTR.
[in] RedirectDir
Chiave di una voce nella tabella Directory del database. Un LPCWSTR può essere usato al posto di un BSTR. Questo parametro può essere Null o una stringa vuota.
Valore restituito
La funzione Merge restituisce i valori seguenti.
| Valore | Significato |
|---|---|
|
L'unione non è riuscita in modo irreversibile. Indica un errore operativo e non è il normale errore restituito per un'unione non riuscita. |
|
La funzione è riuscita, ma si sono verificati errori e l'unione stessa potrebbe non essere valida. |
|
Uno degli argomenti non è valido. |
|
Il sistema ha esaurito la memoria e non è riuscito a completare l'operazione. |
|
Funzione completata. |
Commenti
Questa funzione esegue un'unione del database corrente e del modulo corrente. La radice dell'albero di directory del modulo viene reindirizzata alla posizione specificata da RedirectDir. Se si verificano conflitti di merge, incluse le esclusioni, vengono inseriti nell'enumeratore di errore per il recupero successivo, ma non causa l'esito negativo dell'unione. È possibile recuperare gli errori usando la funzione get_Errors . Gli errori e i messaggi informativi vengono inseriti nel file di log corrente.
Si noti che la funzione Merge ottiene tutti i riferimenti alle funzionalità nel modulo e sostituisce il riferimento di funzionalità per tutte le occorrenze del GUID Null nel database del modulo. Per altre informazioni, vedere Riferimento alle funzionalità nei moduli di merge.
Al termine dell'unione, i componenti nel modulo vengono collegati alla funzionalità identificata da Feature. Questa funzionalità deve esistere già e non viene creata.
Il modulo può essere collegato a funzionalità aggiuntive usando la funzione Connect . Si noti che la chiamata alla funzione Connect crea solo associazioni di componenti di funzionalità. Non modifica le righe già unite nel database.
Le modifiche apportate al database non vengono salvate su disco a meno che la funzione CloseDatabase non venga chiamata con bCommit impostato su TRUE.
Requisiti
| Client minimo supportato | Mergemod.dll 1.0 o versione successiva |
| Piattaforma di destinazione | Windows |
| Intestazione | mergemod.h |
| DLL | Mergemod.dll |