virtual P6R::P6ERR P6R::p6ISign2::sign ( P6CRYPTODATASOURCE *  pInData, P6CRYPTODATASINK *  pOutData, P6BOOL  base64Encode, P6SIGNHMAC  hmac  )

pure virtual

Sign the data pointed to by pInData given the key and the key type set in setKey.

setKey() must be called at least once before this function is called. If either an RSA, EC, or DSA cipher is desired then the private key must be passed to setKey() before this function is called. If SYM is used then the shared symetric key must be passed first to setKey().

A data source can be a buffer or a file. A data source can be text or binary data. The resulting signature (a binary value) can be encoded into ASCII by placing it into a base64 representation. The resulting signature can be written out to a buffer or to a file by itself. Note that if a file is the data sink, then any existing contents of that file are erased before the signature is written to it.

When signing using DSA keys, the hmac specified MUST be SH_SHA1.

Parameters

pInData	[ in ] Generate a signature for this input data.
pOutData	[ in ] Pointer to where to copy the signature value.
base64Encode	[ in ] Flag indicating whether the signature should be encoded in base64 (otherwise it is binary string)
hmac	[ in ] the hash algorithm to use for the message digest. See P6R::P6SIGNHMAC.

Returns

Success	P6R::eOk
Failure	eNotInitialized	A successful call to initialize was not made before this call.
	eFormatError	A DSA private key has not been loaded via loadDSAKeyPair.
	eInvalidArg	One of the parameters is NULL.
	eNotFound	File data source does not exist.
	eIoError	Write to file data sink failed.
	eTooSmall	The buffer data sink is too small to contain the generated value.
	eTooBig	Internal error
	eMissingKey	setKey must be called before this function.
	eWrongKeyClass	Private or symetric keys only can sign data.
	eInvalidHMAC	A DSA key is being used for signing, but the HMAC specified was not SH_SHA1.
	eFailAndException	The signature calculation failed. Exception record provides detailed error info.