GetDriverString

Declaration

Note: This function is restricted to result string up to maximal 256 characters . To be compatible to all key use the function GetDriverStringA.

Delphi

function GetDriverString(Key: Cardinal): ShortString;

C/C++

SOPAD_API void SOPAD_GetDriverString(DWORD dwKey, char szValue[SOPAD_MAX_STRING_LENGTH]);

ActiveX

HRESULT GetDriverString([in] long Key, [out, retval] BSTR* Result);

Description

This function returns string values.

Arguments

Key

Numerical value, must be equal to one of possible values from the table (see below).

szValue

String value which corresponds to the Key.

Possible combinations of key and value

Possible combinations of key and value are listed int the table.

KeyValue
0Configured device name
1Serial number of device or empty string
3XML certificate
4Page number string (for color devices)
5Hash sum of device public key 1
6Firmware version
7unused
8unused
9Get the Password for Virtual hosted WLAN (SMARTPhone with soWifiCom.dll )
10Get the SSID name for Virtual hosted WLAN (SMARTPhone with soWifiCom.dll )
11

Function retrieves CryptoID container  information from device or returns NULL if pad does not support CryptoID V2. The Result is  formated to XML and the  XSD definition can found in the Samples section.

Return value

Function returns string value which corresponds to the Key parameter.