IPWorks Encrypt 2020 C++ Edition

Questions / Feedback?

ReferenceXMLElement Property

This property specifies XML element to sign or verify using XPath notation.

Syntax

ANSI (Cross Platform)
char* GetReferenceXMLElement(int iReferenceIndex);
int SetReferenceXMLElement(int iReferenceIndex, const char* lpszReferenceXMLElement); Unicode (Windows) LPWSTR GetReferenceXMLElement(INT iReferenceIndex);
INT SetReferenceXMLElement(INT iReferenceIndex, LPCWSTR lpszReferenceXMLElement);
- (NSString*)referenceXMLElement:(int)referenceIndex;
- (void)setReferenceXMLElement:(int)referenceIndex:(NSString*)newReferenceXMLElement;
#define PID_XMLSIG_REFERENCEXMLELEMENT 18

IPWORKSENCRYPT_EXTERNAL void* IPWORKSENCRYPT_CALL IPWorksEncrypt_XMLSig_Get(void *lpObj, int propid, int arridx, int *lpcbVal, int64 *lpllVal);
IPWORKSENCRYPT_EXTERNAL int IPWORKSENCRYPT_CALL IPWorksEncrypt_XMLSig_Set(void *lpObj, int propid, int arridx, const void *val, int cbVal);
IPWORKSENCRYPT_EXTERNAL int IPWORKSENCRYPT_CALL IPWorksEncrypt_XMLSig_CheckIndex(void *lpObj, int propid, int arridx);

Default Value

"/"

Remarks

This property specifies XML element to sign or verify using XPath notation. When signing, this must be set before calling Sign. When verifying, this must be set from within the SignatureInfo event. The ReferenceURI property may be used to help identify the correct XML element.

/root/myElement XPath syntax
/root/[1] XPath syntax using an index
/root/ns:myElement XPath syntax where the element has a namespace
myElement Just the element name
@id=myid Attribute selector: This will select an element with an attribute "id" whose value is "myid".
/root/myElement[1]/ns:name2[@attr=attrValue] XPath syntax using an index and attribute selector

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

This property is not available at design time.

Data Type

String

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