DAOpenFileWithEncryptionKeyA

Dokumenthantering, direktåtkomstfunktioner, säkerhet

Beskrivning

Det efterföljande A betecknar DLL-singången för ANSI (char); ActiveX/COM-ytan exponerar bara Unicode-formen. Beteendet är identiskt med DAOpenFileWithEncryptionKey och strängargumenten tolkas med den aktuella SetAnsiMode-kodsidanÖppnar en krypterad PDF för auktoriserad återställning eller undersökning genom att ta emot den hexadecimala filkrypteringsnyckeln direkt i stället för att härleda den från ett lösenordFilen öppnas via ett källskrivskyddat handtag och kan inte tilläggsskrivas på plats

Syntax

Delphi

Function DLDAOpenFileWithEncryptionKeyA(InstanceID: Integer; InputFileName, EncryptionKeyHex: PAnsiChar; Options: Integer): Integer; Stdcall;

DLL

int DLDAOpenFileWithEncryptionKeyA(int InstanceID, const char * InputFileName, const char * EncryptionKeyHex, int Options);

Parametrar

InputFileNameSökvägen och namnet på den krypterade PDF-filen
EncryptionKeyHexEn hexadecimal ASCII-nyckel med jämn längd, utan prefix eller blanksteg; revision 2 till 4 kräver den exakta nyckellängd som krypteringsordlistan deklarerar och revision 5 till 7 kräver 32 byte
OptionsNoll kräver en tillgänglig verifierare; PDF_RAW_KEY_ALLOW_UNVERIFIED tillåter en i övrigt giltig nyckel bara när dokumentet saknar användbar verifierare

Returvärden

Skilt från nollEtt filhandtag med direktåtkomst
0Indata kunde inte öppnas; granska LastErrorCode, inklusive PDFLIB_ERROR_RAW_ENCRYPTION_KEY_INVALID för ogiltig syntax, längd, alternativ eller verifiering

Anmärkningar

Tillgängliga värden för /U i revision 2 till 4 och för /Perms i revision 5 till 7 kontrolleras alltid; PDF_RAW_KEY_ALLOW_UNVERIFIED accepterar aldrig en inkongruensAnropa

DAGetEncryptionKeyValidation efter öppningen för att skilja verifierade handtag från uttryckligen overifieradeANSI-strängarna breddas med den aktuella

SetAnsiMode-kodsidan innan begäran behandlasNyckeln är känslig autentiseringsdata och bör hämtas, överföras och lagras under samma kontroller som ett dokumentlösenord