IRunningObjectTable::NoteChangeTime

Artigo
09/09/2008

Windows Mobile Supported Windows Embedded CE Supported

9/8/2008

Este método registra o tempo que uma execução objeto foi modificado pela última vez. O objeto deve foram previamente registrado com o Running Object Table (ROT). Este método armazena o tempo da última alteração de ROT.

Syntax

HRESULT NoteChangeTime(
  DWORD dwRegister,
  FILETIME* pfiletime 
);

Parameters

dwRegister
[no] Valor que identifica a entrada ROT do objeto alterado. Este valor anteriormente foi retornado por IRunningObjectTable::Register.

pfiletime
[no] Ponteiro para um FILETIME estrutura contendo último alteração tempo do objeto.

Return Value

Este método oferece suporte a padrão valor de retorno E_INVALIDARG, bem como o seguinte:

S_OK
O tempo alteração foi gravado com êxito.

Remarks

O tempo registrado por este método pode ser recuperado por chamado IRunningObjectTable::GetTimeOfLastChange.

Este método é fornecido para habilitar um programa para verificar se uma conexão entre dois objetos (representados por um objeto mantendo um moniker que identifica o outro) é atualizado.

De exemplo, se um objeto está mantendo em cache informações sobre o outro objeto, esse método pode ser usado para verificar se o objeto foi modificado desde a armazenar em cache foi atualizado pela última vez. Consulte IMoniker::GetTimeOfLastChange.

Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.

Notas para chamadores

Se você for um provedor moniker (ou seja, você mão fora monikers identificando os objetos para torná-los acessível a outras pessoas), você deve chamar o IRunningObjectTable::NoteChangeTime método sempre que os objetos são modificados.

Você deve ter anteriormente chamado IRunningObjectTable::Register e armazenado o identificador retornado por esse método; Você usa esse identificador quando chamado IRunningObjectTable::NoteChangeTime.

The most comum tipo de provedor moniker é um compostos-origem link documento. Isso inclui aplicativos servidor que suporte vinculação a seus documentos (ou partes de um documento) e aplicativos contêiner que suporte vinculação a embeddings dentro de seus documentos.

Aplicativos de servidor que não podem de vinculação não suporte também utilizar o ROT Para cooperar com aplicativos contêiner que suporte vinculação a embeddings.

Quando um objeto primeiro é registrado no ROT, o ROT registra seu último tempo alteração como o valor retornado por chamado IMoniker::GetTimeOfLastChange Sobre o moniker sendo registrado.

Requirements

Header	objidl.h, objidl.idl
Library	ole32.lib, uuid.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

Compartilhar via