Gestore della classeclass FileHandler

Interfaccia per tutte le funzioni di gestione file.Interface for all file handling functions.

RiepilogoSummary

MembriMembers DescrizioniDescriptions
public std:: shared_ptr <ContentLabel> GetLabel ()public std::shared_ptr<ContentLabel> GetLabel() Avvia il recupero dell'etichetta di riservatezza dal file.Starts retrieving the sensitivity label from the file.
public std:: Vector <std::pair<std::string, std::string> > GetProperties (versione uint32_t)public std::vector<std::pair<std::string, std::string>> GetProperties(uint32_t version) Recupera il file propertries in base alla versione.Retrievs the file propertries according to version.
public std:: shared_ptr <ProtectionHandler> getprotection ()public std::shared_ptr<ProtectionHandler> GetProtection() Avvia il recupero dei criteri di protezione dal file.Starts retrieving the protection policy from the file.
public void RegisterContentForTrackingAndRevocationAsync (bool isOwnerNotificationEnabled, const std:: shared_ptr <ProtectionEngine::Observer>& Observer, const std:: shared_ptr <void>& context)public void RegisterContentForTrackingAndRevocationAsync(bool isOwnerNotificationEnabled, const std::shared_ptr<ProtectionEngine::Observer>& observer, const std::shared_ptr<void>& context) Parametri # # # ##### Parameters
public void RevokeContentAsync (const std:: shared_ptr <ProtectionEngine::Observer>& Observer, const std:: shared_ptr <void>& context)public void RevokeContentAsync(const std::shared_ptr<ProtectionEngine::Observer>& observer, const std::shared_ptr<void>& context) Eseguire la revoca per il contenuto.Perform revocation for the content.
public void ClassifyAsync (const std:: shared_ptr <void>& context)public void ClassifyAsync(const std::shared_ptr<void>& context) Esegue le regole nel gestore e restituisce l'elenco di azioni da eseguire.Executes the rules in the handler and returns the list of actions to be executed.
public void InspectAsync (const std:: shared_ptr <void>& context)public void InspectAsync(const std::shared_ptr<void>& context) Creare un oggetto Inspector di file, utilizzato per recuperare il contenuto del file da formati di file compatibili.Create a file inspector object, used to retrieve file contents from compatible file formats.
public void selabel (const std:: shared_ptr <Label>& Label, const LabelingOptions& LabelingOptions, const ProtectionSettings& ProtectionSettings)public void SetLabel(const std::shared_ptr<Label>& label, const LabelingOptions& labelingOptions, const ProtectionSettings& protectionSettings) Imposta l'etichetta di riservatezza per il file.Sets the sensitivity label to the file.
public void DeleteLabel(const LabelingOptions& labelingOptions)public void DeleteLabel(const LabelingOptions& labelingOptions) Elimina l'etichetta di riservatezza dal file.Deletes the sensitivity label from the file.
public void seprotection (const std:: shared_ptr <ProtectionDescriptor>& protectionDescriptor, const ProtectionSettings& ProtectionSettings)public void SetProtection(const std::shared_ptr<ProtectionDescriptor>& protectionDescriptor, const ProtectionSettings& protectionSettings) Imposta autorizzazioni personalizzate o basate su modello (in base a protectionDescriptor->GetProtectionType) per il file.Sets either custom or template-based permissions (according to protectionDescriptor->GetProtectionType) to the file.
public void seprotection (const std:: shared_ptr <ProtectionHandler>& protectionHandler)public void SetProtection(const std::shared_ptr<ProtectionHandler>& protectionHandler) Imposta la protezione su un documento utilizzando un gestore di protezione esistente.Sets protection on a document using an existing protection handler.
public void RemoveProtection()public void RemoveProtection() Rimuove la protezione dal file.Removes protection from the file. Se il formato di file originale non supporta l'assegnazione di etichette, l'etichetta andrà persa quando viene rimossa la protezione.If the original file format does not support labeling, the label will be lost when protection is removed. Quando il formato nativo supporta l'assegnazione di etichette, i metadati dell'etichetta vengono mantenuti.When the native format supports labeling, the label metadata is maintained.
public void CommitAsync(const std::string& outputFilePath, const std::shared_ptr<void>& context)public void CommitAsync(const std::string& outputFilePath, const std::shared_ptr<void>& context) Scrive le modifiche nel file specificato dal parametro |outputFilePathWrites the changes to the file specified by the |outputFilePath\ parametri.parameter.
public void CommitAsync(const std::shared_ptr<Stream>& outputStream, const std::shared_ptr<void>& context)public void CommitAsync(const std::shared_ptr<Stream>& outputStream, const std::shared_ptr<void>& context) Scrive le modifiche nel flusso specificato dal parametro |outputStreamWrites the changes to the stream specified by the |outputStream\ parametri.parameter.
bool pubblico ()public bool IsModified() Verifica se sono presenti modifiche di cui eseguire il commit nel file.Checks if there are changes to commit to the file.
public void GetDecryptedTemporaryFileAsync (const std:: shared_ptr <void>& context)public void GetDecryptedTemporaryFileAsync(const std::shared_ptr<void>& context) Restituisce il percorso di un file temporaneo, che verrà eliminato se possibile, che rappresenta il contenuto decrittografato.Returns a path to a temporary file (that will be deleted if possible) - representing the decrypted content.
public void GetDecryptedTemporaryStreamAsync (const std:: shared_ptr <void>& context)public void GetDecryptedTemporaryStreamAsync(const std::shared_ptr<void>& context) Restituisce un flusso che rappresenta il contenuto decrittografato.Returns a stream - representing the decrypted content.
public void NotifyCommitSuccessful (const std:: String& actualFilePath)public void NotifyCommitSuccessful(const std::string& actualFilePath) Da chiamare quando è stato eseguito il commit delle modifiche su disco.To be called when the changes have been committed to disk.
public std::string GetOutputFileName()public std::string GetOutputFileName() Calcola il nome e l'estensione del file di output in base al nome file originale e alle modifiche accumulate.Calculates the output file name and extension based on the original file name and the accumulated changes.

MembriMembers

Funzione GetLabelGetLabel function

Avvia il recupero dell'etichetta di riservatezza dal file.Starts retrieving the sensitivity label from the file.

GetProperties (funzione)GetProperties function

Recupera il file propertries in base alla versione.Retrievs the file propertries according to version.

Funzione getprotectionGetProtection function

Avvia il recupero dei criteri di protezione dal file.Starts retrieving the protection policy from the file.

RegisterContentForTrackingAndRevocationAsync (funzione)RegisterContentForTrackingAndRevocationAsync function

ParametriParameters:

  • isOwnerNotificationEnabled: impostare su true per notificare al proprietario via posta elettronica ogni volta che il documento viene decrittografato oppure false per non inviare la notifica.isOwnerNotificationEnabled: Set to true to notify the owner via email whenever the document is decrypted, or false to not send the notification.

  • observer: classe che implementa l'interfaccia ProtectionHandler::Observerobserver: A class implementing the ProtectionHandler::Observer interface

  • contesto: contesto client che verrà inviato in modo opaco agli osservatori e HttpDelegate facoltativicontext: Client context that will be opaquely forwarded to observers and optional HttpDelegate

Restituisce: oggetto controllo asincrono.Returns: Async control object.

RevokeContentAsync (funzione)RevokeContentAsync function

Eseguire la revoca per il contenuto.Perform revocation for the content.

ParametriParameters:

  • observer: classe che implementa l'interfaccia ProtectionHandler::Observerobserver: A class implementing the ProtectionHandler::Observer interface

  • contesto: contesto client che verrà inviato in modo opaco agli osservatori e HttpDelegate facoltativicontext: Client context that will be opaquely forwarded to observers and optional HttpDelegate

Restituisce: oggetto controllo asincrono.Returns: Async control object.

ClassifyAsync (funzione)ClassifyAsync function

Esegue le regole nel gestore e restituisce l'elenco di azioni da eseguire.Executes the rules in the handler and returns the list of actions to be executed.

Restituisce: elenco di azioni da applicare al contenuto.Returns: List of actions that should be applied on the content.

InspectAsync (funzione)InspectAsync function

Creare un oggetto Inspector di file, utilizzato per recuperare il contenuto del file da formati di file compatibili.Create a file inspector object, used to retrieve file contents from compatible file formats.

Restituisce: controllo file.Returns: A file inspector.

Funzione di etichettaSetLabel function

Imposta l'etichetta di riservatezza per il file.Sets the sensitivity label to the file. Le modifiche non verranno scritte nel file finché non viene chiamato CommitAsync.Changes won't be written to the file until CommitAsync is called. I metodi Auto e Privileged consentono all'API di eseguire l'override di qualsiasi etichetta esistente. Genera JustificationRequiredError quando l'impostazione dell'etichetta richiede che l'operazione sia giustificata (tramite il parametro labelingOptions).Privileged and Auto method allows the API to override any existing label Throws JustificationRequiredError when setting the label requires the operation to be justified (via the labelingOptions parameter).

DeleteLabel (funzione)DeleteLabel function

Elimina l'etichetta di riservatezza dal file.Deletes the sensitivity label from the file. Le modifiche non verranno scritte nel file finché non viene chiamato CommitAsync.Changes won't be written to the file until CommitAsync is called. I metodi Auto e Privileged consentono all'API di eseguire l'override di qualsiasi etichetta esistente. Genera JustificationRequiredError quando l'impostazione dell'etichetta richiede che l'operazione sia giustificata (tramite il parametro labelingOptions).Privileged and Auto method allows the API to override any existing label Throws JustificationRequiredError when setting the label requires the operation to be justified (via the labelingOptions parameter).

Funzione seprotectionSetProtection function

Imposta autorizzazioni personalizzate o basate su modello (in base a protectionDescriptor->GetProtectionType) per il file.Sets either custom or template-based permissions (according to protectionDescriptor->GetProtectionType) to the file. Le modifiche non verranno scritte nel file finché non viene chiamato CommitAsync.Changes won't be written to the file until CommitAsync is called.

Funzione seprotectionSetProtection function

Imposta la protezione su un documento utilizzando un gestore di protezione esistente.Sets protection on a document using an existing protection handler. Le modifiche non verranno scritte nel file finché non viene chiamato CommitAsync.Changes won't be written to the file until CommitAsync is called.

RemoveProtection (funzione)RemoveProtection function

Rimuove la protezione dal file.Removes protection from the file. Se il formato di file originale non supporta l'assegnazione di etichette, l'etichetta andrà persa quando viene rimossa la protezione.If the original file format does not support labeling, the label will be lost when protection is removed. Quando il formato nativo supporta l'assegnazione di etichette, i metadati dell'etichetta vengono mantenuti.When the native format supports labeling, the label metadata is maintained. Le modifiche non verranno scritte nel file finché non viene chiamato CommitAsync.Changes won't be written to the file until CommitAsync is called.

CommitAsync (funzione)CommitAsync function

Scrive le modifiche nel file specificato dal parametro |outputFilePath|.Writes the changes to the file specified by the |outputFilePath| parameter. In base all'esito positivo o negativo dell'operazione verrà chiamato FileHandler::Observer.FileHandler::Observer will be called upon success or failure.

CommitAsync (funzione)CommitAsync function

Scrive le modifiche nel flusso specificato dal parametro |outputStream|.Writes the changes to the stream specified by the |outputStream| parameter. In base all'esito positivo o negativo dell'operazione verrà chiamato FileHandler::Observer.FileHandler::Observer will be called upon success or failure.

Funzione modifiedIsModified function

Verifica se sono presenti modifiche di cui eseguire il commit nel file.Checks if there are changes to commit to the file. Le modifiche non verranno scritte nel file finché non viene chiamato CommitAsync.Changes won't be written to the file until CommitAsync is called.

GetDecryptedTemporaryFileAsync (funzione)GetDecryptedTemporaryFileAsync function

Restituisce il percorso di un file temporaneo, che verrà eliminato se possibile, che rappresenta il contenuto decrittografato.Returns a path to a temporary file (that will be deleted if possible) - representing the decrypted content. In base all'esito positivo o negativo dell'operazione verrà chiamato FileHandler::Observer.FileHandler::Observer will be called upon success or failure.

GetDecryptedTemporaryStreamAsync (funzione)GetDecryptedTemporaryStreamAsync function

Restituisce un flusso che rappresenta il contenuto decrittografato.Returns a stream - representing the decrypted content. In base all'esito positivo o negativo dell'operazione verrà chiamato FileHandler::Observer.FileHandler::Observer will be called upon success or failure.

NotifyCommitSuccessful (funzione)NotifyCommitSuccessful function

Da chiamare quando è stato eseguito il commit delle modifiche su disco.To be called when the changes have been committed to disk.

ParametriParameters:

  • actualFilePath: percorso file effettivo per il file di outputactualFilePath: The actual file path for the output file

Genera un evento di controlloFires an Audit event

GetOutputFileName (funzione)GetOutputFileName function

Calcola il nome e l'estensione del file di output in base al nome file originale e alle modifiche accumulate.Calculates the output file name and extension based on the original file name and the accumulated changes.