Método IPropertyStorage::SetTimes (propidlbase.h)

O método SetTimes define os tempos de modificação, acesso e criação desse conjunto de propriedades, se houver suporte para a implementação. Nem todas as implementações dão suporte a todos esses valores de tempo.

Sintaxe

HRESULT SetTimes(
  [in] const FILETIME *pctime,
  [in] const FILETIME *patime,
  [in] const FILETIME *pmtime
);

Parâmetros

[in] pctime

Ponteiro para o novo tempo de criação do conjunto de propriedades. Pode ser NULL, indicando que desta vez não deve ser modificado por essa chamada.

[in] patime

Ponteiro para o novo tempo de acesso para o conjunto de propriedades. Pode ser NULL, indicando que desta vez não deve ser modificado por essa chamada.

[in] pmtime

Ponteiro para o novo tempo de modificação para o conjunto de propriedades. Pode ser NULL, indicando que desta vez não deve ser modificado por essa chamada.

Retornar valor

Esse método dá suporte ao valor de retorno padrão E_UNEXPECTED, além do seguinte:

Comentários

Define os tempos de modificação, acesso e criação do conjunto de propriedades aberto atual, se compatível com a implementação (nem todas as implementações dão suporte a todos esses valores de tempo). Os carimbos de data/hora sem suporte são sempre relatados como zero, permitindo que o chamador teste o suporte. Uma chamada para IPropertyStorage::Stat fornece (entre outros dados) informações de carimbo de data/hora.

Observe que essa funcionalidade é fornecida como um método IPropertyStorage em um objeto de armazenamento de propriedades que já está aberto, ao contrário de ser fornecido como um método em IPropertySetStorage. Normalmente, quando o método SetTimes não é chamado explicitamente, os tempos de acesso e modificação são atualizados como um efeito colateral da leitura e gravação do conjunto de propriedades. Quando SetTimes é usado, os horários especificados mais recentes substituem os valores de hora ou horário padrão especificados em chamadas anteriores para SetTimes.

Requisitos

Confira também

FILETIME

IPropertyStorage

IPropertyStorage::Stat