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 IDs de item de sincronização. Esse valor será NULL se nenhum item estiver pendente.

[out] ppenumPunks

Tipo: IEnumUnknown**

Quando esse 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.

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um valor de erro, caso contrário. Retornará 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

Requisito	Valor
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