153 lines
5.1 KiB
C++
153 lines
5.1 KiB
C++
// CkSecureStringW.h: interface for the CkSecureStringW class.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////
|
|
|
|
// This header is generated for Chilkat 11.3.0
|
|
|
|
#ifndef _CkSecureStringW_H
|
|
#define _CkSecureStringW_H
|
|
|
|
#include "chilkatDefs.h"
|
|
#include "CkString.h"
|
|
#include "CkWideCharBase.h"
|
|
|
|
class CkStringBuilderW;
|
|
|
|
|
|
|
|
#if !defined(__sun__) && !defined(__sun)
|
|
#pragma pack (push, 8)
|
|
#endif
|
|
|
|
|
|
// CLASS: CkSecureStringW
|
|
class CK_VISIBLE_PUBLIC CkSecureStringW : public CkWideCharBase
|
|
{
|
|
|
|
|
|
private:
|
|
|
|
// Don't allow assignment or copying these objects.
|
|
CkSecureStringW(const CkSecureStringW &);
|
|
CkSecureStringW &operator=(const CkSecureStringW &);
|
|
|
|
public:
|
|
CkSecureStringW(void);
|
|
virtual ~CkSecureStringW(void);
|
|
|
|
|
|
|
|
static CkSecureStringW *createNew(void);
|
|
|
|
|
|
|
|
void CK_VISIBLE_PRIVATE inject(void *impl);
|
|
|
|
// May be called when finished with the object to free/dispose of any
|
|
// internal resources held by the object.
|
|
void dispose(void);
|
|
|
|
|
|
|
|
// BEGIN PUBLIC INTERFACE
|
|
|
|
// ----------------------
|
|
// Properties
|
|
// ----------------------
|
|
// If set to the name of a hash algorithm, then a hash of the current string value
|
|
// is maintained. This allows for the hash to be verified via the VerifyHash
|
|
// method. Possible hash algorithm names are sha1 , sha256 , sha384 , sha512 , md5
|
|
// , md2 , ripemd160 , ripemd128 , ripemd256 , and ripemd320 .
|
|
void get_MaintainHash(CkString &str);
|
|
// If set to the name of a hash algorithm, then a hash of the current string value
|
|
// is maintained. This allows for the hash to be verified via the VerifyHash
|
|
// method. Possible hash algorithm names are sha1 , sha256 , sha384 , sha512 , md5
|
|
// , md2 , ripemd160 , ripemd128 , ripemd256 , and ripemd320 .
|
|
const wchar_t *maintainHash(void);
|
|
// If set to the name of a hash algorithm, then a hash of the current string value
|
|
// is maintained. This allows for the hash to be verified via the VerifyHash
|
|
// method. Possible hash algorithm names are sha1 , sha256 , sha384 , sha512 , md5
|
|
// , md2 , ripemd160 , ripemd128 , ripemd256 , and ripemd320 .
|
|
void put_MaintainHash(const wchar_t *newVal);
|
|
|
|
// Can be set to true to make this secure string read-only (cannot be modified).
|
|
bool get_ReadOnly(void);
|
|
// Can be set to true to make this secure string read-only (cannot be modified).
|
|
void put_ReadOnly(bool newVal);
|
|
|
|
|
|
|
|
// ----------------------
|
|
// Methods
|
|
// ----------------------
|
|
// Returns the clear-text string value.
|
|
bool Access(CkString &outStr);
|
|
// Returns the clear-text string value.
|
|
const wchar_t *access(void);
|
|
|
|
// Appends a clear-text string to this secure string. The in-memory data will be
|
|
// decrypted, the string will be appended, and then it will be re-encrypted. Can
|
|
// return false if the string has been marked as read-only via the ReadOnly
|
|
// property.
|
|
bool Append(const wchar_t *str);
|
|
|
|
// Appends a clear-text string contained in a StringBuilder to this secure string.
|
|
// The in-memory data will be decrypted, the string will be appended, and then it
|
|
// will be re-encrypted. Can return false if the string has been marked as
|
|
// read-only via the ReadOnly property.
|
|
bool AppendSb(CkStringBuilderW &sb);
|
|
|
|
// Appends the contents of a secure string to this secure string. The in-memory
|
|
// data will be decrypted, the secure string will be appended, and then it will be
|
|
// re-encrypted. Can return false if this string has been marked as read-only via
|
|
// the ReadOnly property.
|
|
bool AppendSecure(CkSecureStringW &secStr);
|
|
|
|
// Returns the hash value for the current value of this secure string. The encoding
|
|
// specifies the encoding to be used. It can be any of the binary encoding
|
|
// algorithms, such as base64 , hex , and many more listed at Chilkat Binary
|
|
// Encodings
|
|
//
|
|
// References:
|
|
// 1: https://www.chilkatsoft.com/binary_encodings.asp
|
|
bool HashVal(const wchar_t *encoding, CkString &outStr);
|
|
// Returns the hash value for the current value of this secure string. The encoding
|
|
// specifies the encoding to be used. It can be any of the binary encoding
|
|
// algorithms, such as base64 , hex , and many more listed at Chilkat Binary
|
|
// Encodings
|
|
//
|
|
// References:
|
|
// 1: https://www.chilkatsoft.com/binary_encodings.asp
|
|
const wchar_t *hashVal(const wchar_t *encoding);
|
|
|
|
// Loads the contents of a file into this secure string. The current contents of
|
|
// this object are replaced with the new text from the file.
|
|
bool LoadFile(const wchar_t *path, const wchar_t *charset);
|
|
|
|
// Returns true if the secStr equals the contents of this secure string.
|
|
bool SecStrEquals(CkSecureStringW &secStr);
|
|
|
|
// Verifies the hashVal against the hash value stored for the current value of this
|
|
// secure string. The MaintainHash property must've previously been set for this
|
|
// secure string to maintain an internal hash. The encoding specifies the encoding of
|
|
// the hashVal. It can be any of the binary encoding algorithms, such as base64 , hex
|
|
// , and many more listed at Chilkat Binary Encodings
|
|
//
|
|
// References:
|
|
// 1: https://www.chilkatsoft.com/binary_encodings.asp
|
|
bool VerifyHash(const wchar_t *hashVal, const wchar_t *encoding);
|
|
|
|
|
|
|
|
|
|
|
|
// END PUBLIC INTERFACE
|
|
|
|
|
|
};
|
|
#if !defined(__sun__) && !defined(__sun)
|
|
#pragma pack (pop)
|
|
#endif
|
|
|
|
#endif
|