CryptMsgCalculateEncodedLength function (wincrypt.h)
The CryptMsgCalculateEncodedLength function calculates the maximum number of bytes needed for an encoded cryptographic message given the message type, encoding parameters, and total length of the data to be encoded. Note that the result will always be greater than or equal to the actual number of bytes needed.
DWORD CryptMsgCalculateEncodedLength( [in] DWORD dwMsgEncodingType, [in] DWORD dwFlags, [in] DWORD dwMsgType, [in] void const *pvMsgEncodeInfo, [in, optional] LPSTR pszInnerContentObjID, [in] DWORD cbData );
Specifies the encoding type used. It is always acceptable to specify both the certificate and message encoding types by combining them with a bitwise-OR operation as shown in the following example:
X509_ASN_ENCODING | PKCS_7_ASN_ENCODING
Currently defined encoding types are:
Currently defined flags are shown in the following table.
||Indicates that streamed output will not have an outer ContentInfo wrapper (as defined by PKCS #7). This makes it suitable to be streamed into an enclosing message.|
||Indicates that there is detached data being supplied for the subsequent calls to CryptMsgUpdate.|
||Used to calculate the size of a DER encoding of a message to be nested inside an enveloped message. This is particularly useful when streaming is being performed.|
||Non-Data type inner content is encapsulated within an OCTET STRING. This flag is applicable for both Signed and Enveloped messages.|
Currently defined message types are shown in the following table.
||An octet (BYTE) string.|
A pointer to the data to be encoded. The type of data pointed to depends on the value of dwMsgType. For details, see the dwMsgType table.
[in, optional] pszInnerContentObjID
When calling CryptMsgCalculateEncodedLength with data provided to CryptMsgUpdate already encoded, the appropriate object identifier is passed in pszInnerContentObjID. If pszInnerContentObjID is NULL, the inner content type is assumed not to have been previously encoded, and is encoded as an octet string and given the type CMSG_DATA.
When streaming is being used, pszInnerContentObjID must be either NULL or szOID_RSA_data.
The following algorithm object identifiers are commonly used:
The size, in bytes, of the content.
Returns the required length for an encoded cryptographic message. This length might not be the exact length but it will not be less than the required length. Zero is returned if the function fails.
To retrieve extended error information, use the GetLastError function. The following table lists the error codes most commonly returned.
||The message type is not valid.|
||The cryptographic algorithm is unknown.|
||One or more arguments are not valid.|
|Minimum supported client||Windows XP [desktop apps | UWP apps]|
|Minimum supported server||Windows Server 2003 [desktop apps | UWP apps]|