CreateSecret Method

Creates a new secret.

Syntax

int CreateSecret(const QString& qsSecretName);

Remarks

This method creates a new secret with the given SecretName. The secret data is taken from the specified LocalFile or the SecretData property; it may be up to 65536 bytes in length.

The value passed for SecretName must consist solely of alphanumeric characters, hyphens (-), and underscores (_); and may be up to 255 characters in length.

If there are any items in the Label* properties, they will be applied to the newly-created secret. Secrets may have up to 64 labels.

Note that this method makes two requests: the first one creates the empty secret itself (which is just a container for secret versions), and the second one creates an initial secret version with the actual secret data (as if CreateVersion had been called). The Id of the initial secret version is always 1.

Error Handling

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)