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

Confira também

IMoniker::GetTimeOfLastChange

Irunningobjecttable