classe FileHandler

Interface para todas as funções de manipulação de arquivos.

Resumo

Membros	Descrições
public std::shared_ptr<ContentLabel GetLabel> ()	Inicia a recuperação do rótulo de sensibilidade do arquivo.
public std::vector<std::p air<std::string, std::string>> GetProperties(uint32_t version)	Recupera as propriedades do arquivo de acordo com a versão.
public std::shared_ptr<ProtectionHandler> GetProtection()	Inicia a recuperação da política de proteção do arquivo.
public void RegisterContentForTrackingAndRevocationAsync(bool isOwnerNotificationEnabled, const std::shared_ptr ProtectionEngine::Observer>& observer, const std::shared_ptr<<void>& context)	Registre o conteúdo para rastreamento e revogação.
public void RevokeContentAsync(const std::shared_ptr ProtectionEngine::Observer>& observer, const std::shared_ptr<<void>& context)	Execute a revogação do conteúdo.
public void ClassifyAsync(const std::shared_ptr<void>& contexto)	Executa as regras no manipulador e retorna a lista de ações a serem executadas.
public void InspectAsync(const std::shared_ptr<void>& contexto)	Crie um objeto de inspetor de arquivo, usado para recuperar o conteúdo do arquivo de formatos de arquivo compatíveis.
public void SetLabel(const std::shared_ptr<Label>& label, const LabelingOptions& labelingOptions, const ProtectionSettings& protectionSettings)	Define o rótulo de sensibilidade para o arquivo.
public void DeleteLabel(const LabelingOptions& labelingOptions)	Exclui o rótulo de confidencialidade do arquivo.
public void SetProtection(const std::shared_ptr<ProtectionDescriptor& protectionDescriptor>, const ProtectionSettings& protectionSettings)	Define permissões personalizadas ou baseadas em modelo (de acordo com protectionDescriptor-GetProtectionType>) para o arquivo.
public void SetProtection(const std::shared_ptr<ProtectionHandler& protectionHandler>)	Define a proteção em um documento usando um manipulador de proteção existente.
public void RemoveProtection()	Remove a proteção do arquivo. Se o formato de arquivo original não oferecer suporte à rotulagem, o rótulo será perdido quando a proteção for removida. Quando o formato nativo oferece suporte à rotulagem, os metadados do rótulo são mantidos.
public void CommitAsync(const std::string& outputFilePath, const std::shared_ptr<void>& context)	Grava as alterações no arquivo especificado pelo parâmetro outputFilePath.
public void CommitAsync(const std::shared_ptr Stream& outputStream>, const std::shared_ptr<<void>& context)	Grava as alterações no fluxo especificado pelo parâmetro outputStream.
bool público IsModified()	Verifica se há alterações a serem confirmadas no arquivo.
public void GetDecryptedTemporaryFileAsync(const std::shared_ptr<void>& context)	Retorna um caminho para um arquivo temporário (que será excluído, se possível) - representando o conteúdo descriptografado.
public void GetDecryptedTemporaryStreamAsync(const std::shared_ptr<void>& context)	Retorna um fluxo - representando o conteúdo descriptografado.
public void NotifyCommitSuccessful(const std::string& actualFilePath)	A ser chamado quando as alterações tiverem sido confirmadas no disco.
public std::string GetOutputFileName()	Calcula o nome e a extensão do arquivo de saída com base no nome do arquivo original e nas alterações acumuladas.

Membros

Função GetLabel

Inicia a recuperação do rótulo de sensibilidade do arquivo.

Exceções

• NotSupportedError: quando um mecanismo somente de proteção está em uso e nenhum manipulador de política é encontrado.

Função GetProperties

Recupera as propriedades do arquivo de acordo com a versão.

Função GetProtection

Inicia a recuperação da política de proteção do arquivo.

Função RegisterContentForTrackingAndRevocationAsync

Registre o conteúdo para rastreamento e revogação.

Parâmetros:

• isOwnerNotificationEnabled: defina como true para notificar o proprietário por e-mail sempre que o documento for descriptografado ou false para não enviar a notificação.

• observer: Uma classe que implementa a interface ProtectionHandler::Observer

• contexto: contexto do cliente que será encaminhado de forma opaca para observadores e HttpDelegate opcional

Retornos: objeto de controle assíncrono.

Função RevokeContentAsync

Execute a revogação do conteúdo.

Parâmetros:

• observer: Uma classe que implementa a interface ProtectionHandler::Observer

• contexto: contexto do cliente que será encaminhado de forma opaca para observadores e HttpDelegate opcional

Retornos: objeto de controle assíncrono.

Função ClassifyAsync

Executa as regras no manipulador e retorna a lista de ações a serem executadas.

Devoluções: lista de ações que devem ser aplicadas no conteúdo.

Exceções

• NotSupportedError: quando um mecanismo somente de proteção está em uso e nenhum manipulador de política é encontrado.

Função InspectAsync

Crie um objeto de inspetor de arquivo, usado para recuperar o conteúdo do arquivo de formatos de arquivo compatíveis.

Retornos: um inspetor de arquivos.

Função SetLabel

Define o rótulo de sensibilidade para o arquivo. As alterações não serão gravadas no arquivo até que CommitAsync seja chamado. O método Privileged e Auto permite que a API substitua qualquer rótulo existente Lança JustificationRequiredError ao definir o rótulo requer que a operação seja justificada (por meio do parâmetro labelingOptions).

Exceções

• NotSupportedError: quando um mecanismo somente de proteção está em uso e nenhum manipulador de política é encontrado.

Função DeleteLabel

Exclui o rótulo de confidencialidade do arquivo. As alterações não serão gravadas no arquivo até que CommitAsync seja chamado. O método Privileged e Auto permite que a API substitua qualquer rótulo existente Lança JustificationRequiredError ao definir o rótulo requer que a operação seja justificada (por meio do parâmetro labelingOptions).

Exceções

• NotSupportedError: quando um mecanismo somente de proteção está em uso e nenhum manipulador de política é encontrado.

Função SetProtection

Define permissões personalizadas ou baseadas em modelo (de acordo com protectionDescriptor-GetProtectionType>) para o arquivo. As alterações não serão gravadas no arquivo até que CommitAsync seja chamado.

Função SetProtection

Define a proteção em um documento usando um manipulador de proteção existente. As alterações não serão gravadas no arquivo até que CommitAsync seja chamado.

Função RemoveProtection

Remove a proteção do arquivo. Se o formato de arquivo original não oferecer suporte à rotulagem, o rótulo será perdido quando a proteção for removida. Quando o formato nativo oferece suporte à rotulagem, os metadados do rótulo são mantidos. As alterações não serão gravadas no arquivo até que CommitAsync seja chamado.

Função CommitAsync

Grava as alterações no arquivo especificado pelo |outputFilePath| parâmetro. FileHandler::Observer será chamado em caso de sucesso ou falha. Se o espaço em disco do arquivo de saída for insuficiente, a função FileHandler::CommitAsync pode gerar arquivos corrompidos. Nesse caso, exclua os arquivos corrompidos e ajuste o tamanho do disco ou escolha outro disco antes de tentar novamente a operação.

Função CommitAsync

Grava as alterações no fluxo especificado pelo |outputStream| parâmetro. |saídaStream| não deve ser o mesmo que inputStream usado para criar o manipulador. FileHandler::Observer será chamado em caso de sucesso ou falha. Se o espaço em disco do arquivo de saída for insuficiente, a função FileHandler::CommitAsync pode gerar arquivos corrompidos. Nesse caso, exclua os arquivos corrompidos e ajuste o tamanho do disco ou escolha outro disco antes de tentar novamente a operação.

Função IsModified

Verifica se há alterações a serem confirmadas no arquivo. As alterações não serão gravadas no arquivo até que CommitAsync seja chamado.

Função GetDecryptedTemporaryFileAsync

Retorna um caminho para um arquivo temporário (que será excluído, se possível) - representando o conteúdo descriptografado. FileHandler::Observer será chamado em caso de sucesso ou falha.

Função GetDecryptedTemporaryStreamAsync

Retorna um fluxo - representando o conteúdo descriptografado. FileHandler::Observer será chamado em caso de sucesso ou falha.

Função NotifyCommitSuccessful

A ser chamado quando as alterações tiverem sido confirmadas no disco.

Parâmetros:

• actualFilePath: O caminho do arquivo real para o arquivo de saída

Dispara um evento de auditoria

Exceções

• NotSupportedError: quando um mecanismo somente de proteção está em uso e nenhum manipulador de política é encontrado.

Função GetOutputFileName

Calcula o nome e a extensão do arquivo de saída com base no nome do arquivo original e nas alterações acumuladas.