EncryptFileA
Segurança e assinaturas
Descrição
O sufixo A indica o ponto de entrada ANSI (char) da DLL; a superfície ActiveX/COM expõe apenas a forma Unicode. O comportamento é idêntico ao de EncryptFile e os argumentos de cadeia de caracteres são interpretados com base na página de código atual definida por SetAnsiMode
Encripta um ficheiro no disco e guarda os resultados num novo ficheiro. Não é necessário carregar todo o documento para a memória, pelo que esta função pode ser utilizada para encriptar documentos enormes
Sintaxe
Delphi
Function DLEncryptFileA(InstanceID: Integer; InputFileName, OutputFileName, Owner, User: PAnsiChar; Strength, Permissions: Integer): Integer;
DLL
int DLEncryptFileA(int InstanceID, const char * InputFileName, const char * OutputFileName, const char * Owner, const char * User, int Strength, int Permissions);
Parâmetros
| InputFileName | O nome do ficheiro a encriptar |
|---|---|
| OutputFileName | O nome do ficheiro de destino a criar |
| Owner | A palavra-passe do proprietário a utilizar para o ficheiro encriptado. É por vezes denominada palavra-passe "master" ou de "permissions". Esta palavra-passe será necessária para alterar o documento. A palavra-passe do utilizador a utilizar para o ficheiro encriptado. É por vezes denominada palavra-passe de "open"; permitirá ao utilizador abrir o documento, mas não utilizá-lo de formas não permitidas |
| User | |
| Strength | A robustez da encriptação a utilizar: 0 = encriptação RC4 de 40 bits 1 = encriptação RC4 de 128 bits 2 = encriptação AES de 128 bits (requer Acrobat 7 ou posterior) 3 = encriptação AES de 256 bits (requer Acrobat 9 ou posterior) 4 = encriptação AES de 256 bits (requer Acorbat X ou posterior) |
| Permissions | Um valor criado com a função EncodePermissions |
Valores devolvidos
| 0 | Não foi possível encriptar o ficheiro. Verifique o resultado de LastErrorCode |
|---|---|
| 1 | O documento foi encriptado com êxito |