GetIDProp Method

Returns an element of the SAML ID.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
char* GetIDProp(const char* lpszID, const char* lpszPropName);

Unicode (Windows)
LPWSTR GetIDProp(LPCWSTR lpszID, LPCWSTR lpszPropName);

- (NSString*)getIDProp:(NSString*)ID :(NSString*)propName;

#define MID_SAMLWRITER_GETIDPROP 8

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

Remarks

This is a utility method that simplifies retrieval of a specific property within a SAML ID. Pass the name of the ID property to the PropName parameter, and the ID to the ID parameter.

The following ID properties are supported:

• Format
• NameQualifier
• IDType
• SPNameQualifier
• SPProvidedID
• Value

Error Handling (C++)

This method returns a String value; after it returns, call the GetLastErrorCode() method to obtain its 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.