Método ISyncMgrSyncCallback::QueryForAdditionalItems (syncmgr.h)

Recupera um enumerador do conjunto de itens que têm uma solicitação pendente a ser sincronizada. Esse é o conjunto de itens que serão sincronizados após a conclusão da sincronização atual.

Sintaxe

HRESULT QueryForAdditionalItems(
  [out] IEnumString  **ppenumItemIDs,
  [out] IEnumUnknown **ppenumPunks
);

Parâmetros

[out] ppenumItemIDs

Tipo: IEnumString**

Quando esse método retorna, contém o endereço de um ponteiro para uma instância de IEnumString que enumera as IDs de item de sincronização. Esse valor será NULL se nenhum item estiver pendente.

[out] ppenumPunks

Tipo: IEnumUnknown**

Quando este método retorna, contém o endereço de um ponteiro para uma instância de IEnumUnknown enumerando interfaces IUnknown que são passadas para StartHandlerSync ou StartItemSync. Esse valor será NULL se nenhuma interface estiver pendente.

Valor retornado

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um valor de erro caso contrário. Retorna S_FALSE se nenhum item estiver pendente.

Comentários

As IDs de item recuperadas por uma chamada para o método Next da interface do enumerador recuperada têm um comprimento máximo de MAX_SYNCMGR_ID incluindo o caractere nulo de terminação. O aplicativo de chamada é responsável por desalocar cada ID de item recuperada por meio do método Next usando CoTaskMemFree.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho syncmgr.h