Método IStorage::SetElementTimes (objidl.h)

  • Artigo

O método SetElementTimes define os tempos de modificação, acesso e criação do elemento de armazenamento especificado, se o sistema de arquivos subjacente der suporte a esse método.

Sintaxe

HRESULT SetElementTimes(
  [in] const OLECHAR  *pwcsName,
  [in] const FILETIME *pctime,
  [in] const FILETIME *patime,
  [in] const FILETIME *pmtime
);

Parâmetros

[in] pwcsName

O nome do elemento de objeto de armazenamento cujos horários devem ser modificados. Se FOR NULL, a hora será definida no armazenamento raiz em vez de um de seus elementos.

[in] pctime

O novo tempo de criação para o elemento ou NULL se o tempo de criação não for modificado.

[in] patime

O novo tempo de acesso para o elemento ou NULL se o tempo de acesso não for modificado.

[in] pmtime

O novo tempo de modificação para o elemento ou NULL se o tempo de modificação não for modificado.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK Os valores de tempo foram definidos com êxito.
E_PENDING Somente armazenamento assíncrono: parte ou todos os dados do elemento estão indisponíveis no momento.
STG_E_ACCESSDENIED O chamador não tem permissões suficientes para alterar o elemento.
STG_E_FILENOTFOUND O elemento com o nome especificado não existe.
STG_E_INSUFFICIENTMEMORY O elemento não foi alterado devido à falta de memória.
STG_E_INVALIDNAME Não é um valor válido para o nome do elemento.
STG_E_INVALIDPOINTER O ponteiro especificado para o elemento não era válido.
STG_E_INVALIDPARAMETER Um dos parâmetros não era válido.
STG_E_TOOMANYOPENFILES O elemento não foi alterado porque há muitos arquivos abertos.
STG_E_REVERTED O objeto de armazenamento foi invalidado por uma operação de reverter acima dele na árvore de transações.

Comentários

SetElementTimes define estatísticas de tempo para o elemento de armazenamento especificado dentro desse objeto de armazenamento.

Nem todos os sistemas de arquivos dão suporte a todos os valores de tempo. Esse método define os horários com suporte e ignora o restante. Cada parâmetro time-value pode ser NULL; indicando que nenhuma modificação deve ocorrer.

Chame o método IStorage::Stat para recuperar esses valores de tempo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho objidl.h
Biblioteca Uuid.lib
DLL Ole32.dll

Confira também

IStorage – Implementação de arquivo composto

IStorage::Stat