Download Summit Software Developer`s Kit

Transcript
Programmers Guide
Summit SDK
Returns:




SDCERR_SUCCESS – Successful
SDCERR_INVALID_PARAMETER if an invalid parameter
SDCERR_INVALID_CONFIG if an invalid config
SDCERR_FAIL – Error
GetWAPICertCred
This function retrieves the WAPI EAP credentials
SDCERR GetWAPICertCred(SDCConfig * cfg,
char * username, char* userCert,
CERTLOCATION* certLocation, char* caCert);
Parameters:





[in] cfg--a valid configuration, required
[out] username--pass in a valid pointer with an allocated buffer of at least USER_NAME_SZ characters.
if NULL, this parameter is ignored
[out] userCert--pass in a valid pointer with an allocated buffer of at least 20 characters. if NULL, this
parameter is ignored
[out] CAcertLocation--pass in a valid pointer. if NULL, this parameter is ignored
[out] caCert--pass in a valid pointer with an allocated buffer of at least CRED_CERT_SZ characters. if
NULL, this parameter is ignored; depending on the caCertLocation field, caCert will contain:
- if CERT_NONE, caCert is NULL - don't validate the server
- if CERT_FILE, caCert will specify the cert filename, up to CRED_CERT_SZ chars
Return:




SDCERR_SUCCESS if successful
SDCERR_INVALIDPARAMETER if an invalid parameter
SDCERR_INVALID_CONFIG if an invalid config
SDCERR_FAIL if other err
GetWEPKey
This function retrieves a WEP key.
SDCERR GetWEPKey (SDCConfig *cfg, int nWepKey, WEPLEN *keyLength, unsigned char
*key, BOOLEAN *txKey)
Parameters:





[in] cfg – Valid configuration (required)
[out] nWepKey – Indicates which of the four stored WEP keys (1, 2, 3, or 4) to retrieve
[out] keyLength – WEP key length. If NULL, this parameter is ignored
[out] key – Pass in an allocated buffer of at least 26 (hex) characters. If NULL, this parameter is ignored
[out] txKey – Returns if this is the active transmit key. If NULL, this parameter is ignored
Returns:

SDCERR_INVALID_WEP_TYPE – wepType is not WEP_ON or WEP_CKIP
Embedded Wireless Solutions Support Center:
http://ews-support.lairdtech.com
www.lairdtech.com/wireless
33
Laird Technologies
Americas: +1-800-492-2320
Europe: +44-1628-858-940
Hong Kong: +852 2923 0610