ListIdentities Method
Lists the identities of the given type.
Syntax
int ListIdentities(int iIdentityType);
Remarks
This method is used to list the identities of the specified type. The IdentityType parameter specifies the type of identities you wish to list. Possible values are:
IdentityType | Meaning |
0 | |
1 | Domain |
2 | Both Email and Domain |
If the number of results exceeds MaxListIdentityResults the results will be paged. When the results are paged the IsPaged configuration setting will return "True" and the IdentityMarker property will be populated. To obtain the next page of results simply call ListIdentities again. The IdentityMarker value determines the results offset. On the last page of results the IsPaged configuration setting will return "False" and IdentityMarker will be set to empty string. With this design to get all of the results you can repeatedly call ListIdentities until IsPaged returns "False" or IdentityMarker is set to empty string.
Error Handling
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.)