Module secret Methods

AcquireSecretInfo() allocates the SecretInfo structure.

The format of the AcquireSecretInfo method is:

  SecretInfo *AcquireSecretInfo(const char *path,const HashType hash,
    const size_t key_length)

A description of each parameter follows:

path

The secret keyring path.

hash

The hash type.

key_length

The key length in bits.

AuthenticateSecretKey() returns WizardTrue if the caller is authenticated.

The format of the AuthenticateSecretKey method is:

  void AuthenticateSecretKey(SecretInfo *secret_info,
    ExceptionInfo *exception)

A description of each parameter follows:

secret_info

The secret info.

exception

Return any errors or warnings in this structure.

DestroySecretInfo() zeros memory associated with the SecretInfo structure.

The format of the DestroySecretInfo method is:

  SecretInfo *DestroySecretInfo(SecretInfo *secret_info)

A description of each parameter follows:

secret_info

The secret info.

GenerateSecretKey() returns WizardTrue if a key is generated and successfully added to the secret key ring.

The format of the GenerateSecretKey method is:

  WizardBooleanType GenerateSecretKey(SecretInfo *secret_info,
    ExceptionInfo *exception)

A description of each parameter follows:

secret_info

The secret info.

exception

Return any errors or warnings in this structure.

GetSecretId() returns the secret id.

The format of the GetSecretId method is:

  const StringInfo *GetSecretId(const SecretInfo *secret_info)

A description of each parameter follows:

secret_info

The secret info.

GetSecretKey() returns the secret key.

The format of the GetSecretKey method is:

  const StringInfo *GetSecretKey(const SecretInfo *secret_info)

A description of each parameter follows:

secret_info

The secret info.

GetSecretKeyLength() returns the secret key length.

The format of the GetSecretKeyLength method is:

  size_t GetSecretKeyLength(const SecretInfo *secret_info)

A description of each parameter follows:

secret_info

The secret info.

GetSecretPassphrase() returns the secret passphrase.

The format of the GetSecretPassphrase method is:

  const char *GetSecretPassphrase(const SecretInfo *secret_info)

A description of each parameter follows:

secret_info

The secret info.

SetSecretId() sets the secret id.

The format of the SetSecretId method is:

  void SetSecretId(SecretInfo *secret_info,const StringInfo *id)

A description of each parameter follows:

secret_info

The ring info.

id

The id.

SetSecretKeyLength() sets the authentication method key length.

The format of the SetSecretKeyLength method is:

  void SetSecretKeyLength(SecretInfo *secret_info,
    const size_t key_length)

A description of each parameter follows:

secret_info

The secret info.

key_length

The key length in bits.

SetSecretPassphrase() sets the secret passphrase.

The format of the SetSecretPassphrase method is:

  void SetSecretPassphrase(SecretInfo *secret_info,const char *passphrase)

A description of each parameter follows:

secret_info

The secret info.

passphrase

The passphrase.