Método IRunningObjectTable::NoteChangeTime (objidl.h)
Registra a hora em que um objeto em execução foi modificado pela última vez. O objeto deve ter sido registrado anteriormente com a ROT (tabela de objetos em execução). Esse método armazena a hora da última alteração no ROT.
Sintaxe
HRESULT NoteChangeTime(
[in] DWORD dwRegister,
[in] FILETIME *pfiletime
);
Parâmetros
[in] dwRegister
O identificador da entrada ROT do objeto alterado. Esse valor foi retornado anteriormente por IRunningObjectTable::Register.
[in] pfiletime
Um ponteiro para uma estrutura FILETIME que contém a hora da última alteração do objeto.
Retornar valor
Esse método pode retornar os valores retornados padrão E_INVALIDARG e S_OK.
Comentários
O tempo registrado por esse método pode ser recuperado chamando IRunningObjectTable::GetTimeOfLastChange.
Anotações aos Chamadores
Um provedor de moniker (distribui monikers que identificam seus objetos para torná-los acessíveis a outras pessoas) deve chamar o método NoteChangeTime sempre que seus objetos são modificados. Ele deve ter chamado anteriormente IRunningObjectTable::Register e armazenado o identificador retornado por esse método; ele usa esse identificador ao chamar NoteChangeTime.O tipo mais comum de provedor de moniker é uma fonte de link de documento composto. Isso inclui aplicativos de servidor que dão suporte à vinculação a documentos (ou partes de um documento) e aplicativos de contêiner que dão suporte à vinculação a inserções em seus documentos. Aplicativos de servidor que não dão suporte à vinculação também podem usar o ROT para cooperar com aplicativos de contêiner que dão suporte à vinculação a inserções.
Quando um objeto é registrado pela primeira vez no ROT, o ROT registra sua última hora de alteração como o valor retornado chamando IMoniker::GetTimeOfLastChange no moniker que está sendo registrado.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | objidl.h |