AddBodyReference Method

Creates a new XML reference to the Body element of the SOAP message.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int AddBodyReference(const char* lpszCustomId, int bAutoGenerateId);

Unicode (Windows)
INT AddBodyReference(LPCWSTR lpszCustomId, BOOL bAutoGenerateId);

- (void)addBodyReference:(NSString*)customId :(BOOL)autoGenerateId;

#define MID_SOAPQUICKSIGNER_ADDBODYREFERENCE 2

SECUREBLACKBOX_EXTERNAL int SECUREBLACKBOX_CALL SecureBlackbox_SOAPQuickSigner_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

Use this method to add a reference to the Body element of the SOAP message.

The reference's URI is set basing on the ID of the XML element. If the XML element doesn't have an ID then a CustomId value will be used. If CustomId is empty and AutoGenerateId is set, the ID will be generated automatically. An exception will be thrown otherwise.

Use CanonicalizationMethod and HashAlgorithm properties to specify the canonicalization method and hash algorithm to use.

Error Handling (C++)

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.)