Merge.MergeEx, metodo

Il metodo MergeEx dell'oggetto Merge equivale alla funzione Merge , ad eccezione del fatto che accetta un argomento aggiuntivo. L'argomento pConfiguration è un'interfaccia implementata dal client. L'argomento può essere Null. La presenza di questo argomento indica che il client è in grado di supportare la funzionalità di configurazione, ma non obbliga il client a fornire i dati di configurazione per qualsiasi elemento configurabile specifico.

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.

Sintassi

Merge.MergeEx(
  Feature,
  RedirectDir,
  pConfiguration
)

Parametri

Funzionalità

Nome di una funzionalità nel database.

RedirectDir

Chiave di una voce nella tabella Directory del database. Questo parametro può essere Null o una stringa vuota.

pConfiguration

L'argomento pConfiguration è un'interfaccia implementata dal client. L'argomento può essere Null. La presenza di questo argomento indica che il client è in grado di supportare la funzionalità di configurazione, ma non obbliga il client a fornire i dati di configurazione per qualsiasi elemento configurabile specifico.

Valore restituito

Questo metodo non restituisce valori.

Commenti

Al termine dell'unione, i componenti nel modulo vengono collegati alla funzionalità identificata da Feature. Questa funzionalità non viene creata e deve essere una funzionalità esistente. Il modulo può essere collegato a funzionalità aggiuntive usando il metodo Connect .

Le modifiche apportate al database vengono salvate se e solo se il metodo CloseDatabase viene chiamato con bCommit impostato su TRUE.

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. Gli errori possono essere recuperati tramite la proprietà Errors . Gli errori e i messaggi informativi vengono inseriti nel file di log corrente.

Quando l'unione ha esito negativo a causa di una configurazione non corretta del modulo, la funzione MergeEx restituisce E_FAIL. Sono inclusi questi errori msmErrorType: msmErrorBadNullSubstitution, msmErrorBadSubstitutionType, msmErrorBadNullResponse, msmErrorMissingConfigItem e msmErrorDataRequestFailed. Questi errori causano l'arresto immediato dell'unione quando viene rilevato l'errore. L'oggetto error viene comunque aggiunto all'enumeratore quando MergeEx restituisce E_FAIL. Per altre informazioni sugli errori msmErrorType, vedere funzione get_Type (oggetto Error).For more information about msmErrorType errors, see get_Type Function (Error Object). Tutti gli altri errori causano la restituzione di mergeEx S_FALSE e la continuazione dell'unione.

C++

Vedere Funzione MergeEx .

Requisiti

Requisito	Valore
Versione	Mergemod.dll 2.0 o versione successiva
Intestazione	Mergemod.h
DLL	Mergemod.dll