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.

 

IMsmMerge::Merge Tutte le versioni di Mergemod.dll.

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
E_FAIL	L'unione non è riuscita in modo irreversibile. Indica un errore operativo e non è il normale errore restituito per un'unione non riuscita.
S_FALSE	La funzione è riuscita, ma si sono verificati errori e l'unione stessa potrebbe non essere valida.
E_INVALIDARG	Uno degli argomenti non è valido.
E_OUTOFMEMORY	Il sistema ha esaurito la memoria e non è riuscito a completare l'operazione.
S_OK	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

Vedi anche

Automazione dei moduli di merge