DAOpenFileWithEncryptionKeyA
Gestion de documents, fonctionnalités d'accès direct, sécurité
Description
Le suffixe A désigne le point d'entrée DLL ANSI (char) ; la surface ActiveX/COM n'expose que la forme Unicode. Le comportement est identique à celui de DAOpenFileWithEncryptionKey et les arguments de chaînes sont interprétés selon la page de codes SetAnsiMode couranteOuvre un PDF chiffré pour une récupération ou une investigation autorisée en acceptant directement la clé de chiffrement de fichier hexadécimale au lieu de la dériver d'un mot de passeLe fichier est ouvert via un handle dont la source est en lecture seule et ne peut pas être complété sur place
Syntaxe
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);Paramètres
| InputFileName | Le chemin et le nom du PDF chiffré |
|---|---|
| EncryptionKeyHex | Une clé hexadécimale ASCII de longueur paire sans préfixe ni espace ; les révisions 2 à 4 exigent la longueur de clé exacte déclarée par le dictionnaire de chiffrement et les révisions 5 à 7 exigent 32 octets |
| Options | Zéro exige un vérificateur disponible ; PDF_RAW_KEY_ALLOW_UNVERIFIED n'accepte une clé par ailleurs valide que lorsque le document n'a aucun vérificateur utilisable |
Valeurs de retour
| Non-zero | Un handle de fichier en accès direct |
|---|---|
| 0 | L'entrée n'a pas pu être ouverte ; inspectez LastErrorCode, notamment PDFLIB_ERROR_RAW_ENCRYPTION_KEY_INVALID pour une syntaxe, une longueur, des options ou une vérification invalides |
Remarques
Les valeurs /U disponibles des révisions 2 à 4 et les valeurs /Perms des révisions 5 à 7 sont toujours vérifiées ; PDF_RAW_KEY_ALLOW_UNVERIFIED n'accepte jamais une non-concordanceAppelez
DAGetEncryptionKeyValidation après l'ouverture pour distinguer les handles vérifiés des handles explicitement non vérifiésLes chaînes ANSI sont élargies avec la page de codes
SetAnsiMode courante avant que la requête ne soit traitéeLa clé est une donnée d'authentification sensible et doit être obtenue, transportée et stockée sous les mêmes contrôles qu'un mot de passe de document