klasse FileHandler

Interface voor alle bestandsverwerkingsfuncties.

Samenvatting

Leden	Omschrijvingen
openbare std::shared_ptr<ContentLabel GetLabel> ()	Begint met het ophalen van het vertrouwelijkheidslabel uit het bestand.
public std::vector<std::p air<std::string, std::string>> GetProperties(uint32_t version)	Haalt de bestandseigenschappen op volgens versie.
openbare std::shared_ptr<ProtectionHandler> GetProtection()	Hiermee wordt het beveiligingsbeleid opgehaald uit het bestand.
public void RegisterContentForTrackingAndRevocationAsync(bool isOwnerNotificationEnabled, const std::shared_ptr<ProtectionEngine::Waarnemer>, const std::shared_ptr<void>&context)	Registreer de inhoud voor het bijhouden en intrekken.
public void RevokeContentAsync(const std::shared_ptr<ProtectionEngine::Observer>& observer, const std::shared_ptr<void>&context)	Intrekking uitvoeren voor de inhoud.
public void ClassifyAsync(const std::shared_ptr<void>&context)	Voert de regels in de handler uit en retourneert de lijst met acties die moeten worden uitgevoerd.
public void InspectAsync(const std::shared_ptr<void>&context)	Maak een bestandscontroleobject dat wordt gebruikt om bestandsinhoud op te halen uit compatibele bestandsindelingen.
public void SetLabel(const std::shared_ptr<Label>&label, const LabelingOptions&labelingOptions, const Protection Instellingen& protection Instellingen)	Hiermee stelt u het vertrouwelijkheidslabel in op het bestand.
public void DeleteLabel(const LabelingOptions& labelingOptions)	Hiermee verwijdert u het vertrouwelijkheidslabel uit het bestand.
public void SetProtection(const std::shared_ptr<ProtectionDescriptor& protectionDescriptor>, const Protection Instellingen& protection Instellingen)	Hiermee stelt u aangepaste of op sjablonen gebaseerde machtigingen (volgens protectionDescriptor-GetProtectionType>) in op het bestand.
public void SetProtection(const std::shared_ptr<ProtectionHandler& protectionHandler>)	Hiermee stelt u de beveiliging voor een document in met behulp van een bestaande beveiligingshandler.
public void RemoveProtection()	Hiermee verwijdert u de beveiliging van het bestand. Als de oorspronkelijke bestandsindeling geen ondersteuning biedt voor labelen, gaat het label verloren wanneer de beveiliging wordt verwijderd. Wanneer de systeemeigen indeling labelen ondersteunt, blijven de metagegevens van het label behouden.
public void CommitAsync(const std::string& outputFilePath, const std::shared_ptr<void>& context)	Hiermee schrijft u de wijzigingen in het bestand dat is opgegeven door de parameter outputFilePath.
public void CommitAsync(const std::shared_ptr<Stream>& outputStream, const std::shared_ptr<void>&context)	Hiermee schrijft u de wijzigingen naar de stream die is opgegeven door de parameter outputStream.
openbare bool IsModified()	Controleert of er wijzigingen zijn om het bestand door te voeren.
public void GetDecryptedTemporaryFileAsync(const std::shared_ptr<void>&context)	Retourneert een pad naar een tijdelijk bestand (dat indien mogelijk wordt verwijderd) - die de ontsleutelde inhoud vertegenwoordigt.
public void GetDecryptedTemporaryStreamAsync(const std::shared_ptr<void>&context)	Hiermee wordt een stream geretourneerd die de ontsleutelde inhoud vertegenwoordigt.
public void NotifyCommitSuccessful(const std::string& actualFilePath)	Worden aangeroepen wanneer de wijzigingen zijn doorgevoerd op schijf.
public std::string GetOutputFileName()	Berekent de naam en extensie van het uitvoerbestand op basis van de oorspronkelijke bestandsnaam en de samengevoegde wijzigingen.

Leden

GetLabel, functie

Begint met het ophalen van het vertrouwelijkheidslabel uit het bestand.

Uitzonderingen

• NotSupportedError: wanneer er alleen een engine voor beveiliging wordt gebruikt en er geen beleidshandler wordt gevonden.

GetProperties, functie

Haalt de bestandseigenschappen op volgens versie.

GetProtection, functie

Hiermee wordt het beveiligingsbeleid opgehaald uit het bestand.

RegisterContentForTrackingAndRevocationAsync, functie

Registreer de inhoud voor het bijhouden en intrekken.

Parameters:

• isOwnerNotificationEnabled: stel in op true om de eigenaar per e-mail op de hoogte te stellen wanneer het document wordt ontsleuteld of onwaar om de melding niet te verzenden.

• waarnemer: Een klasse die de ProtectionHandler::Waarnemer-interface implementeert

• context: Clientcontext die ondoorzichtig wordt doorgestuurd naar waarnemers en optionele HttpDelegate

Retourneert: Asynchroon besturingsobject.

De functie RevokeContentAsync

Intrekking uitvoeren voor de inhoud.

Parameters:

• waarnemer: Een klasse die de ProtectionHandler::Waarnemer-interface implementeert

• context: Clientcontext die ondoorzichtig wordt doorgestuurd naar waarnemers en optionele HttpDelegate

Retourneert: Asynchroon besturingsobject.

ClassificerenAsync, functie

Voert de regels in de handler uit en retourneert de lijst met acties die moeten worden uitgevoerd.

Retourneert: Lijst met acties die moeten worden toegepast op de inhoud.

Uitzonderingen

• NotSupportedError: wanneer er alleen een engine voor beveiliging wordt gebruikt en er geen beleidshandler wordt gevonden.

InspectAsync, functie

Maak een bestandscontroleobject dat wordt gebruikt om bestandsinhoud op te halen uit compatibele bestandsindelingen.

Retourneert: Een bestandscontrole.

SetLabel, functie

Hiermee stelt u het vertrouwelijkheidslabel in op het bestand. Wijzigingen worden pas naar het bestand geschreven als CommitAsync wordt aangeroepen. Met de methode Privileged en Auto kan de API een bestaand label Throws JustificationRequiredError overschrijven wanneer het instellen van het label vereist dat de bewerking wordt gerechtvaardigd (via de parameter labelingOptions).

Uitzonderingen

• NotSupportedError: wanneer er alleen een engine voor beveiliging wordt gebruikt en er geen beleidshandler wordt gevonden.

DeleteLabel, functie

Hiermee verwijdert u het vertrouwelijkheidslabel uit het bestand. Wijzigingen worden pas naar het bestand geschreven als CommitAsync wordt aangeroepen. Met de methode Privileged en Auto kan de API een bestaand label Throws JustificationRequiredError overschrijven wanneer het instellen van het label vereist dat de bewerking wordt gerechtvaardigd (via de parameter labelingOptions).

Uitzonderingen

• NotSupportedError: wanneer er alleen een engine voor beveiliging wordt gebruikt en er geen beleidshandler wordt gevonden.

SetProtection, functie

Hiermee stelt u aangepaste of op sjablonen gebaseerde machtigingen (volgens protectionDescriptor-GetProtectionType>) in op het bestand. Wijzigingen worden pas naar het bestand geschreven als CommitAsync wordt aangeroepen.

SetProtection, functie

Hiermee stelt u de beveiliging voor een document in met behulp van een bestaande beveiligingshandler. Wijzigingen worden pas naar het bestand geschreven als CommitAsync wordt aangeroepen.

RemoveProtection, functie

Hiermee verwijdert u de beveiliging van het bestand. Als de oorspronkelijke bestandsindeling geen ondersteuning biedt voor labelen, gaat het label verloren wanneer de beveiliging wordt verwijderd. Wanneer de systeemeigen indeling labelen ondersteunt, blijven de metagegevens van het label behouden. Wijzigingen worden pas naar het bestand geschreven als CommitAsync wordt aangeroepen.

CommitAsync, functie

Schrijft de wijzigingen in het bestand dat is opgegeven door |outputFilePath| Parameter. FileHandler::Waarnemer wordt opgeroepen op succes of mislukking. Als de schijfruimte van het uitvoerbestand onvoldoende is, kan de functie FileHandler::CommitAsync beschadigde bestanden genereren. In dit geval verwijdert u de beschadigde bestanden en past u de schijfgrootte aan of kiest u een andere schijf voordat u de bewerking opnieuw probeert uit te voeren.

CommitAsync, functie

Schrijft de wijzigingen in de stream die is opgegeven door de |outputStream| Parameter. |outputStream| mag niet hetzelfde zijn als inputStream die wordt gebruikt voor het maken van de handler. FileHandler::Waarnemer wordt opgeroepen op succes of mislukking. Als de schijfruimte van het uitvoerbestand onvoldoende is, kan de functie FileHandler::CommitAsync beschadigde bestanden genereren. In dit geval verwijdert u de beschadigde bestanden en past u de schijfgrootte aan of kiest u een andere schijf voordat u de bewerking opnieuw probeert uit te voeren.

IsModified, functie

Controleert of er wijzigingen zijn om het bestand door te voeren. Wijzigingen worden pas naar het bestand geschreven als CommitAsync wordt aangeroepen.

GetDecryptedTemporaryFileAsync, functie

Retourneert een pad naar een tijdelijk bestand (dat indien mogelijk wordt verwijderd) - die de ontsleutelde inhoud vertegenwoordigt. FileHandler::Waarnemer wordt opgeroepen op succes of mislukking.

GetDecryptedTemporaryStreamAsync, functie

Hiermee wordt een stream geretourneerd die de ontsleutelde inhoud vertegenwoordigt. FileHandler::Waarnemer wordt opgeroepen op succes of mislukking.

NotifyCommitSuccessful, functie

Worden aangeroepen wanneer de wijzigingen zijn doorgevoerd op schijf.

Parameters:

• actualFilePath: het werkelijke bestandspad voor het uitvoerbestand

Een controlegebeurtenis wordt geactiveerd

Uitzonderingen

• NotSupportedError: wanneer er alleen een engine voor beveiliging wordt gebruikt en er geen beleidshandler wordt gevonden.

GetOutputFileName, functie

Berekent de naam en extensie van het uitvoerbestand op basis van de oorspronkelijke bestandsnaam en de samengevoegde wijzigingen.