ReferenceHandle Property

Allows to get or set a 'handle', a unique identifier of the underlying property object.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int64 GetReferenceHandle(int iReferenceIndex);
int SetReferenceHandle(int iReferenceIndex, int64 lReferenceHandle);

Unicode (Windows)
LONG64 GetReferenceHandle(INT iReferenceIndex);
INT SetReferenceHandle(INT iReferenceIndex, LONG64 lReferenceHandle);

- (long long)referenceHandle:(int)referenceIndex;
- (void)setReferenceHandle:(int)referenceIndex:(long long)newReferenceHandle;

#define PID_SOAPSIGNER_REFERENCEHANDLE 53

SECUREBLACKBOX_EXTERNAL void* SECUREBLACKBOX_CALL SecureBlackbox_SOAPSigner_Get(void *lpObj, int propid, int arridx, int *lpcbVal, int64 *lpllVal);
SECUREBLACKBOX_EXTERNAL int SECUREBLACKBOX_CALL SecureBlackbox_SOAPSigner_Set(void *lpObj, int propid, int arridx, const void *val, int cbVal);
SECUREBLACKBOX_EXTERNAL int SECUREBLACKBOX_CALL SecureBlackbox_SOAPSigner_CheckIndex(void *lpObj, int propid, int arridx);

Default Value

0

Remarks

Allows to get or set a 'handle', a unique identifier of the underlying property object. Use this property to assign objects of the same type in a quicker manner, without copying them fieldwise.

When you pass a handle of one object to another, the source object is copied to the destination rather than assigned. It is safe to get rid of the original object after such operation.

  pdfSigner.setSigningCertHandle(certMgr.getCertHandle());

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

Long64