Método IStorage::SetElementTimes (objidl.h)
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 |