| |||
| БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО! | |||
| |||
IReconcilableObject::Reconcile[Now Supported on Windows NT] Reconciles the state of an object with one or more other objects. The reconciliation updates the internal state of the object by merging the states of all objects to form a combined state. HRESULT IReconcilableObject::Reconcile( IreconcileInitiator *pInitiator, DWORD dwFlags, HWND hwndOwner, HWND hwndProgressFeedback, ULONG ulcInput, IMoniker **rgpmkOtherInput, LONG *plOutIndex, IStorage *pstgNewResidues, void *pvReserved ); Parameters pInitiator Address of the IReconcileInitiator interface for the initiator of the reconciliation process. This parameter must not be NULL. dwFlags Control flags for the reconciliation. This parameter may be zero or a combination of these values: RECONCILEF_FEEDBACKWINDOWVALID hwndProgressFeedback is valid. RECONCILEF_MAYBOTHERUSER The briefcase reconciler can prompt for user interaction if it is needed. Without this value, user interaction is not permitted. hwndOwner is valid. RECONCILEF_NORESIDUESOK The briefcase reconciler can ignore requests for residues and carry out reconciliation. Reconcilers that do not support residues should check for this value whenever an initiator requests residues. Without this value, a reconciler that does not support residues must immediately return REC_E_NORESIDUES. RECONCILEF_OMITSELFRESIDUE The briefcase reconciler can discard any residue associated with this object. Initiators typically use this value for reconciliations that loop from generation to generation. RECONCILEF_ONLYYOUWERECHANGED The Reconcile member function is being called to propagate changes in the changed object to other unchanged objects. This value will only be set if the HKEY_CLASSES_ROOT\CLSID\clsid_of_reconciler\SingleChangeHook key exists in the registry. If that key is not present in the registry, the initiator carries out reconciliation by making the other unchanged objects binary identical copies of the changed object. The rgpmkOtherInput monikers identify the other objects. This value will only be set in dwFlags if RECONCILEF_YOUMAYDOTHEUPDATES is also set. If the briefcase reconciler completes the updates itself successfully, REC_S_IDIDTHEUPDATES should be returned and the variable pointed to by plOutIndex should be set to - 1L. Note that S_OK should not be returned on success if this value is set in dwFlags. The initiator will not save the source object's storage if Reconcile returns REC_S_IDIDTHEUPDATES. If the reconciler wishes to fall back to the initiator's bit copy implementation, it may return S_FALSE. RECONCILEF_RESUMEDRECONCILIATION The briefcase reconciler should resume reconciliation, using the partial residues provided. Without this value, the reconciler should ignore any "considered but rejected" information in any of the input versions. RECONCILEF_YOUMAYDOTHEUPDATES The briefcase reconciler may do the updates itself. Without this value, the reconciler may not do the updates itself. If reconciliation is completed successfully, the reconciler should return REC_S_IDIDTHEUPDATES if it did the updates itself or S_OK if it did not do the updates itself. hwndOwner Handle of the parent window to use for child windows that the briefcase reconciler creates. This parameter is valid only if RECONCILEF_MAYBOTHERUSER is specified in dwFlags. hwndProgressFeedback Handle of the progress feedback window displayed by the initiator. This parameter is valid only if RECONCILEF_FEEDBACKWINDOWVALID is specified in dwFlags. The briefcase reconciler may call the SetWindowText function using this window handle to display additional reconciliation status information to the user. ulcInput Number of versions or partial residues specified in dwFlags. This parameter must not be zero. rgpmkOtherInput Address of an array that contains the addresses of the monikers to use to access the versions or partial residues to be reconciled. plOutIndex Address of the variable that receives an index value indicating whether the result of the reconciliation is identical to one of the initial versions. The variable is set to - 1L if the reconciliation result is a combination of two or more versions. Otherwise, it is a zero-based index, with 0 indicating this object, 1 indicating the first version, 2 indicating the second version, and so on. pstgNewResidues Address of the IStorage interface used to store newly created residues. This parameter may be NULL to indicate that residues should not be saved. pvReserved Reserved; must be NULL. Return Values Returns one of the following success values if successful: S_OK Reconciliation was completed successfully, and the changes must be propagated to the other objects. S_FALSE No reconciliation actions were performed. The briefcase reconciler wishes to fall back to the initiator's bit copy implementation. This value may only be returned if RECONCILEF_ONLYYOUWERECHANGED is set in dwFlags. REC_S_IDIDTHEUPDATES Reconciliation was completed successfully, and all the objects involved (the object implementing the Reconcile member function and all the other objects described by the passed-in monikers) have been updated appropriately. The initiator does not need, therefore, to do anything further to propagate the changes. The variable pointed to by plOutIndex should be set to - 1L if Reconcile returns this value. The initiator will not save the source object's storage if Reconcile returns this value. This value may only be returned if RECONCILEF_YOUMAYDOTHEUPDATES was set in dwFlags. REC_S_NOTCOMPLETE The briefcase reconciler completed some, but not all, of the reconciliation. It may need user interaction. The changes will not be propagated to other objects. REC_S_NOTCOMPLETEBUTPROPAGATE The briefcase reconciler completed some, but not all, of the reconciliation. It may need user interaction. The changes will be propagated to the other objects. Otherwise, the member function returns one of the following error values: REC_E_NORESIDUES The briefcase reconciler does not support the generation of residues, so the request for residues is denied. The state of the object is unchanged. REC_E_ABORTED The briefcase reconciler terminated reconciliation in response to a termination request from the initiator (for more information, see IReconcileInitiator::SetAbortCallback). The state of the object is unspecified. REC_E_TOODIFFERENT Reconciliation cannot be carried out because the provided document versions are too dissimilar. REC_E_INEEDTODOTHEUPDATES The object's Reconcile implementation was called with RECONCILEF_YOUMAYDOTHEUPDATES clear in dwFlags; the object's Reconcile implementation requires that value to be set in dwFlags. OLE_E_NOTRUNNING The object is an OLE embedded object that must be run before this operation can be carried out. The state of the object is unchanged. E_UNEXPECTED Unspecified error. See Also IReconcilableObject | |||
| Пригласи друзей и счет твоего мобильника всегда будет положительным! | |||
| |||
| Пригласи друзей и счет твоего мобильника всегда будет положительным! | |||
IReconcilableObject::ВЫВЕРИТЕСЬ[Теперь Поддерживанное на Windows NT] Примиряет состояние объекта с одним или более другими объектами. Примирение корректирует внутреннее состояние объекта объединяя состояния всех объектов против формы комбинированное состояние. HRESULT IReconcilableObject::ВЫВЕРИТЕ( IreconcileInitiator *pInitiator, DWORD dwFlags, HWND hwndOwner, HWND hwndProgressFeedback, ULONG ulcInput, IMoniker **rgpmkOtherInput, ДОЛГО (ДЛИНОЙ) *plOutIndex, IStorage *pstgNewResidues, пустота *pvReserved ); Параметры pInitiator Адресуйте интерфейс IReconcileInitiator для инициатора процесса примирения. Этот параметр не должен быть НЕДЕЙСТВИТЕЛЕН. dwFlags Управляющие флаги для примирения. Этот параметр может быть нулем или комбинация этих величин: RECONCILEF_FEEDBACKWINDOWVALID hwndProgressFeedback в силе. RECONCILEF_MAYBOTHERUSER Портфель reconciler может подсказать для взаимодействия потребителя если он - нужно. Без этой величины, взаимодействие потребителя - не permitted. hwndOwner в силе. RECONCILEF_NORESIDUESOK Портфель reconciler может проигнорировать просьбы об остатках и выполнять примирение. Reconcilers, Что не поддерживать остатки должно проверять на наличие этой величины всякий раз, когда инициатор просит остатки. Без этой величины, reconciler, что не поддерживает остатки должно немедленно возвращать REC_E_NORESIDUES. RECONCILEF_OMITSELFRESIDUE Портфель reconciler может отвергнуть любой остаток связанный этим объектом. Инициаторы обычно используют эту величину для примирений, которые зацикливают от поколения до поколения. RECONCILEF_ONLYYOUWERECHANGED Функция члена Reconcile назваться, чтобы распространяться изменения на измененный объект против других неизменных объектов. Эта величина только будет установлена если ключ HKEY_CLASSES_ROOT\CLSID\clsid_of_reconciler\SingleChangeHook существует в регистрации. Если этот ключ не присутствует в регистрации, инициатор выполняет примирение делая другими неизменными двоичными идентичными копиями объектов измененного объекта. Прозвища rgpmkOtherInput идентифицируют другие объекты. Эта величина только будет установлена в dwFlags если RECONCILEF_YOUMAYDOTHEUPDATES - также устанавливаться. Если портфель reconciler завершает саму коррекцию успешно, REC_S_IDIDTHEUPDATES должен быть возвращан и переменная указанная, чтобы plOutIndex должна быть установлена, чтобы - 1L. Отмечать, что S_OK не должен возвращан в успех если эта величина установлена в dwFlags. Инициатор не сохранит исходное объектное хранение если Выверять возврат REC_S_IDIDTHEUPDATES. Если reconciler хочет снижать в реализацию битовой копии инициатора, это может возвращать S_FALSE. RECONCILEF_RESUMEDRECONCILIATION Портфель reconciler должен продолжать примирение, использовавшее частичные остатки предусматривался. Без этой величины, reconciler должно проигнорировать любую информацию "считавшуюся но отвергшую" в любой из входных версий. RECONCILEF_YOUMAYDOTHEUPDATES Портфель reconciler может делать самой коррекцией. Без этой величины, reconciler не мочь делать самой коррекцией. Если примирение завершается успешно, reconciler должно возвращать REC_S_IDIDTHEUPDATES если оно делало бы самой коррекцией или S_OK если это не делало бы самой коррекцией. hwndOwner Прооперируйте родительское окно, чтобы использоваться для окна ребенка, которое портфель reconciler создает. Этот параметр - в силе только если RECONCILEF_MAYBOTHERUSER определен в dwFlags. hwndProgressFeedback Прооперируйте окно обратной связи прогресса отображенное инициатором. Этот параметр - в силе только если RECONCILEF_FEEDBACKWINDOWVALID определен в dwFlags. Портфель reconciler может назвать функцию SetWindowText, использовавшую эту ручку окна, чтобы отображать информацию статуса дополнительного примирения пользователю. ulcInput Количество версий или частичных остатков определялось в dwFlags. Этот параметр не должен - нулевым. rgpmkOtherInput Адресуйте массив, который содержит адресы имен, чтобы использоваться, чтобы иметь доступ к версиям или частичным остаткам, которые нужно выверяться. plOutIndex Адресуйте переменную, которая получает индексную величину, указывающую независимо результат примирения идентичен одной из начальных версий. Переменная установлена, чтобы - 1L если результат примирения - комбинация двух или больше версий. В противном случае, это - базирующийся нулевой индекс, с 0 указывая этот объект, 1 указывая первую версию, 2 указывая вторую версию, и так далее. pstgNewResidues Адресуйте интерфейс IStorage использованный, чтобы загружать вновь созданные остатки. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН, чтобы указывать, что остатки не должны сохранены. pvReserved Зарезервированное; должно быть НЕДЕЙСТВИТЕЛЬНО. Обратные Величины Возвращает одну из следующих величин успеха если успешно: S_OK Примирение завершалось успешно, и изменения должны быть распространиться на другие объекты. S_FALSE Никакие действия примирения не были выполнены. Портфель reconciler хочет снижать в реализацию битовой копии инициатора. Эта величина может только возвращана если RECONCILEF_ONLYYOUWERECHANGED установлен в dwFlags. REC_S_IDIDTHEUPDATES Примирение завершалось успешно, и все объекты включенные ( объект, осуществляющий элемент Reconcile функциональные и все другие объекты описанные прошедшим-в именах), корректируются соответственно. Инициатор не нужно, следовательно, чтобы делать что-нибудь согласно распространяться изменения. Переменная указанная, чтобы plOutIndex должна быть установлена, чтобы - 1L если Выверять возврату эту величину. Инициатор не сохранит исходную объектную память если Выверять возврату эту величину. Эта величина может только возвращана если RECONCILEF_YOUMAYDOTHEUPDATES был установлен в dwFlags. REC_S_NOTCOMPLETE Портфель reconciler завершал некоторый, но не все, примирения. Ему возможно нужно взаимодействие пользователя. Изменения не будут распространиться на другие объекты. REC_S_NOTCOMPLETEBUTPROPAGATE Портфель reconciler завершал некоторый, но не все, примирения. Ему возможно нужно взаимодействие пользователя. Изменения будут распространиться на другие объекты. В противном случае, функциональный возврат элемента одна из следующих величин ошибки: REC_E_NORESIDUES Портфель reconciler не поддерживает поколение остатков, так что запрос об остатках запрещен. Состояние объекта неизменное. REC_E_ABORTED Портфель reconciler завершал примирение в ответ на запрос завершения из инициатора (более подробно, смотри IReconcileInitiator::SetAbortCallback). Состояние объекта неопределенное. REC_E_TOODIFFERENT Примирение не может быть выполнено поскольку предусмотренные версии документа слишком разнородные. REC_E_INEEDTODOTHEUPDATES Возражать Reconcile реализация была названа очисткой RECONCILEF_YOUMAYDOTHEUPDATES в dwFlags; возражать Reconcile реализация требует, что оценивается, чтобы установлен в dwFlags. OLE_E_NOTRUNNING Объект - OLE вставившее объект, что должно работаться прежде, чем эта операция может быть выполнена. Состояние объекта неизменное. Неопределенная ошибка E_UNEXPECTED. Смотри Также IReconcilableObject | |||
| |||
 |
