Método IRunningObjectTable::GetTimeOfLastChange (objidl.h)

Recupera a hora em que um objeto foi modificado pela última vez.

Sintaxe

HRESULT GetTimeOfLastChange(
  [in]  IMoniker *pmkObjectName,
  [out] FILETIME *pfiletime
);

Parâmetros

[in] pmkObjectName

Um ponteiro para a interface IMoniker no moniker.

[out] pfiletime

Um ponteiro para uma estrutura FILETIME que recebe o último tempo de alteração do objeto.

Retornar valor

Esse método pode retornar os valores a seguir.

Código de retorno	Descrição
S_OK	O método foi concluído com sucesso.
S_FALSE	Não há nenhuma entrada para pmkObjectName no ROT ou que o objeto identificador não está mais em execução (nesse caso, a entrada é revogada).

Comentários

Esse método retorna o tempo de alteração que foi relatado pela última vez para esse objeto por uma chamada para IRunningObjectTable::NoteChangeTime. Se NoteChangeTime não tiver sido chamado anteriormente, o método retornará o tempo que foi registrado quando o objeto foi registrado.

Esse método é fornecido para habilitar a verificação se uma conexão entre dois objetos (representada por um objeto que contém um moniker que identifica o outro) está atualizada. Por exemplo, se um objeto estiver mantendo informações armazenadas em cache sobre o outro objeto, esse método poderá ser usado para marcar se o objeto foi modificado desde que o cache foi atualizado pela última vez. Consulte IMoniker::GetTimeOfLastChange.

Anotações para chamadores

Em geral, você chamará GetTimeOfLastChange somente se estiver escrevendo sua própria classe moniker (ou seja, implementando a interface IMoniker ). Normalmente, você chama esse método da implementação de IMoniker::GetTimeOfLastChange. No entanto, você só deverá fazer isso se o parâmetro pmkToLeft de IMoniker::GetTimeOfLastChange for NULL. Caso contrário, você deve chamar IMoniker::GetTimeOfLastChange no parâmetro pmkToLeft .

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