Método IFhReassociation::GetConfigurationDetails (fhcfg.h)

Artigo
03/05/2024

Esse método enumera as configurações de Histórico de Arquivos que foram descobertas em um dispositivo de armazenamento ou compartilhamento de rede pelo método IFhReassociation::ScanTargetForConfigurations e retorna informações adicionais sobre cada uma das configurações descobertas.

Observação

IFhReassociation foi preterido e pode ser alterado ou indisponível em versões futuras.

Sintaxe

HRESULT GetConfigurationDetails(
  [in]  DWORD    Index,
  [out] BSTR     *UserName,
  [out] BSTR     *PcName,
  [out] FILETIME *BackupTime
);

Parâmetros

[in] Index

Índice baseado em zero de uma configuração descoberta.

[out] UserName

No retorno, contém um ponteiro para uma cadeia de caracteres alocada com SysAllocString que contém o nome da conta de usuário na qual a configuração foi copiada pela última vez.

[out] PcName

No retorno, contém um ponteiro para uma cadeia de caracteres alocada com SysAllocString que contém o nome do computador do qual a configuração foi copiada pela última vez.

[out] BackupTime

No retorno, contém a data e a hora em que a configuração foi copiada em backup pela última vez.

Retornar valor

S_OK sobre o êxito ou um HRESULT malsucedido em caso de falha. Possíveis valores HRESULT malsucedidos incluem valores definidos no arquivo de cabeçalho FhErrors.h.

Se não houver nenhuma configuração de Histórico de Arquivos com o índice especificado, o HRESULT_FROM_WIN32(ERROR_NOT_FOUND) código de erro será retornado.

Comentários

O chamador é responsável por liberar a memória alocada para UserName e PcName chamando SysFreeString em cada um deles.

Para executar a reassociação, uma das configurações enumeradas por esse método deve ser selecionada usando o método IFhReassociation::SelectConfiguration e, em seguida, o método IFhReassociation::P erformReassociation precisa ser chamado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	fhcfg.h