SecureBlackbox 2020 C++ Edition

Questions / Feedback?

AddReference Method

Creates a new XML reference to the specified XML element.

Syntax

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

Unicode (Windows)
INT AddReference(LPCWSTR lpszTargetXmlElement, LPCWSTR lpszCustomId, BOOL bAutoGenerateId);
- (void)addReference:(NSString*)targetXmlElement :(NSString*)customId :(BOOL)autoGenerateId;
#define MID_SOAPSIGNER_ADDREFERENCE 4

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

Remarks

Use this method to add a reference to a particular XML element.

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

Copyright (c) 2022 /n software inc. - All rights reserved.
SecureBlackbox 2020 C++ Edition - Version 20.0 [Build 8166]