GetAuthRequest Method

Prepares data to be sent by the 3DS Server.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
char* GetAuthRequest();

Unicode (Windows)
LPWSTR GetAuthRequest();

- (NSString*)getAuthRequest;

#define MID_CLIENT_GETAUTHREQUEST 7

IPWORKS3DS_EXTERNAL int IPWORKS3DS_CALL IPWorks3DS_Client_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

GetAuthRequest encrypts the device info and prepares all the data necessary to be sent by the 3DS Server class in the SendAuthRequest method.

After calling this method, the returned data must be transmitted via a separate secure channel to the server where 3DS Server is being used.

The following properties are required before calling the method:

Calling this method returns required information used by 3DS Server to send the authentication request. Transmit the value returned by this method to the system where 3DS Server is used. The method used to transmit this value is outside the scope of the class.

See SendAuthRequest for details on sending the authentication request after transmitting the data to the 3DS Server.

Calling this method also populates SDKTransactionId which uniquely identifies this transaction and must be used in subsequent calls relating to this transaction, such as SendChallengeRequest.

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.