Skip to main content

Encr_DeletePasswordFromKeychain (function reference)

By April 20, 2023April 25th, 2023Online Help, Troi Encryptor Plug-in
Troi Encryptor Plug-in > Functions reference > Encr_DeletePasswordFromKeychain
Troi Encryptor Plug-in for FileMaker Pro

Encr_DeletePasswordFromKeychain

Deletes a password from the keychain (for this account and/or yourID).

SyntaxFunction badge

Encr_DeletePasswordFromKeychain ( switches ; account { ; yourID } )

Parameters

switches not used, reserved for future use. Leave blank or put "-Unused"
account the name of the account for this password
yourID (optional) the extra ID that was used for this password

Returned Result

Data type returned

Error code

Result

The returned result is an error code. An error always starts with 2 dollars, followed by the error code. You should always check for errors. Returned error codes can be:

0 No error: the password was deleted from the keychain
$$-25300 The password could not be found in the keychain
$$-50 Parameter error

Originated in

Troi Encryptor Plug-in 3.5

Compatibility

FileMaker Pro 16 to FileMaker Pro 2023

Considerations

The password is safely stored in the keychain and it can be deleted from the keychain without the user needing to enter the (keychain) password. The keychain is unlocked when the user logs in into the operating system.
Be careful when using this function, a deleted password can no longer be retrieved.
If you specify an account and/or yourID combination for which no password exists, the plug-in returns error code $$-25300.

Example

Set Variable [ $ErrorCode ; Encr_DeletePasswordFromKeychain ( "-Unused" ; "John Deere" ) ]

This will delete the password for the account “John Deere” from the keychain.

Example 2

Set Variable [ $ErrorCode ; Encr_DeletePasswordFromKeychain ( "-Unused" ; 
				"Sales" ; "Invoices|Notes|REC1001" ) ]

This will remove the password from the keychain which was stored with the account parameter “Sales” and the yourID parameter “Invoices|Notes|REC1001”.

Used in example file

EncryptAES.fmp12

Related functionsFunction badge

Encr_GetPasswordFromKeychain
Encr_SavePasswordToKeychain

Related script stepScript step badge

Delete Password from Keychain

Related topics

Troi Encryptor Plug-in online help (overview)


Online Help Page for Troi Encryptor Plug-in for 16 to 2023 –> Encr_DeletePasswordFromKeychain (encrp4325) 2023-0425 15:49:27