Intermec 751G GetMac(), GetNetworkMode()

Chapter 3 — Configuring the Computer

82 751G Color Mobile Computer User’s Manual

GetMac()

Call this function to get the MAC address of the 802.11b/g radio. Call

RadioConnect() before calling this function for this function to work properly.

GetNetworkMode()

Call this function to get the current Network Mode (SSID) for the

802.11b/g radio.

Syntax UINT GetMac( TCHAR * );

Parameters Pointer to a character array, which is populated with the MAC address

after a successful call.

Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the

query failed, or ERR_CONNECT_FAILED if a connection with the

radio failed.

Remarks If ERROR_SUCCESS is returned, your TCHAR array is populated with

the formatted MAC address of the adapter, as follows: xx-xx-xx-xx-

xx-xx

Definitions #ifdef DYNAMIC_LOADING

typedef UINT (*PFN_GetMac)(TCHAR *);

#else

UINT GetMac(TCHAR *);

#endif

Syntax UINT GetNetworkMode( ULONG & );

Parameters NDIS_NET_MODE_IBSS 802.11b/g Ad–Hoc Mode.

NDIS_NET_MODE_ESS 802.11b/g Infrastructure Mode.

NDIS_NET_MODE_UNKNOWN Anything Else/Unknown Error

NDIS_NET_AUTO_UNKNOWN Automatic Selection. Use of this option is not supported or

recommended.

NDIS_NET_TYPE_OFDM_5G 5 Gigahertz 54 Mbps

NDIS_NET_TYPE_OFDM_2_4G 802.11b/g 2.4 Gigahertz

Return Values ERROR_ SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or

ERR_CONNECT_FAILED if a connection with the radio failed.

Remarks If ERROR_SUCCESS is returned, your ULONG reference is populated with one of the parameters

listed above.

Definitions #ifdef DYNAMIC_LOADING

typedef UINT (*PFN_GetNetworkMode)(ULONG &);

#else

UINT GetNetworkMode(ULONG &);

#endif

Contents

Main Document Change Record Page Contents 1 2 3 Page 4 5 I Before You Begin Safety Information Global Services and Support Warranty Information Web Support Who Should Read This Document? Related Documents Patent Information Page 1 Ambient Light Sensor Audio System Speaker Microphone External Headset Jack Battery Installing and Charging the Battery Removing the Battery Maximizing Battery Life Beeper Enabling the Registry Storage Enabling the Beeper Adjusting the Beeper Volume Disabling the Beeper Intermec Settings Applet Keypad Backlight for Keypad Key Sequences [Orange] Plane Keys Alpha (Green) Plane Keys LEDs Battery Status LED Scanning/Keypad Shift and Notification LED Alpha (Green) Plane Keys (continued) Resetting Your Computer Scanning Bar Codes Scanning with the Area Imager Improving the Performance of the Area Imager Software Build Version Software Tools SmartSystems Foundation Console (www.intermec.com/SmartSystems) SmartSystems Platform Bundles (SSPB) Intermec Resource Kits (www.intermec.com/IDL) Storage Media Accessing the Secure Digital Card Slot Internal Card Slots and Connector Attaching a Tab to the Secure Digital Card Accessing Files Stored on the Secure Digital Card Removing the Secure Digital Card Wireless Network Support Accessories Physical and Environmental Specifications Display Environmental Secure Digital Expansion Slots Page Page 2 Software Builds Where to Find Information Basic Skills Desktop Screen Programs Start Menu and Task Bar Notifications Entering Information Typing With the Onscreen Keyboard Using Transcriber Selecting Typed Text Finding and Organizing Information Customizing Your Computer Adjusting Settings Adding or Removing Programs Adding Programs Using Microsoft ActiveSync Adding a Program Directly from the Internet Adding a Program to the Start Menu Removing Programs Microsoft ActiveSync Microsoft WordPad Creating a Document Typing Mode Writing Mode Synchronizing WordPad Documents Internet Explorer Viewing Mobile Favorites and Channels Browsing the Internet Page Page Configuring Parameters Configuring the Computer With Intermec Settings Synchronizing the Computer System Time with a Time Server Configuring the Computer through the Network Configuring the Computer in a TCP/IP Direct Connect Network Configuring the Computer in a UDP Plus Network Using Configuration Parameters Configuring the Printer Directly to a Port Directly to a Generic Serial Port Configuring the Scanner Scanner Control and Data Transfer Data Collection Configuration Changing Comm Settings Improving the Performance of the Area Imager Reading Distances EA11 Standard Minimum Reading Distances with 0.04 Setbacks Installing Applications on the Computer Using Microsoft ActiveSync Using a Storage Card Using the SmartSystems Console Using Wavelink Avalanche Installing Cabinet Files Developing Applications for the Computer Packaging Applications for the Computer Launching Your Application Automatically RunAutoRun AutoExec AutoRun AutoCopy AutoReg AutoCab Creating Cab Files Creating Device-Specific Cab Files Creating an .inf File [Version] [CEStrings] [Strings] [CEDevice] Page [DefaultInstall] This describes the name and path of files in which your application resides. [SourceDiskNames] This section describes the name and path of the disk on which your application resides. [SourceDiskFiles] [DestinationDirs] Note: [,subdir] is relative to the location of the .inf file. [CopyFiles] [AddReg] [CEShortCuts] Sample .INF File Page Page Using Installation Functions in Setup.dll After the CAB File Extraction Page Page Creating Cab Files with CAB Wizard A batch file in <program> directory, with these commands, works well: Troubleshooting the CAB Wizard Customization and Lockdown Kernel I/O Controls IOCTL_HAL_GET_DEVICE_INFO IOCTL_HAL_ITC_READ_PARM The id field of the PARMS structure may be one of the following values: ID Field Values Page IOCTL_HAL_ITC_WRITE_SYSPARM Describes and enables the registry save location. ID Field Values IOCTL_HAL_GET_DEVICEID Returns TRUE if function succeeds. Returns FALSE if the function fails. IOCTL_HAL_GET_OAL_VERINFO Returns the HAL version information of the Pocket PC image. IOCTL_HAL_GET_BOOTLOADER_VERINFO IOCTL_HAL_WARMBOOT IOCTL_HAL_COLDBOOT IOCTL_HAL_GET_RESET_INFO Returns TRUE if function succeeds. Returns FALSE if the function fails. Sample IOCTL_HAL_GET_BOOT_DEVICE This IOCTL code allows software to check which device CE booted from. Returns TRUE if function succeeds. Returns FALSE if the function fails. IOCTL_HAL_REBOOT IOCTL_PROCESSOR_INFORMATION Returns TRUE if function succeeds. Returns FALSE if the function fails. IOCTL_GET_CPU_ID Returns Xscale processor ID. Returns TRUE if function succeeds. Returns FALSE if the function fails. Networking APIs Basic Connect/Disconnect Functions RadioConnect() RadioDisconnect() Call this to obtain the radios current association status with a service set. Query Information Functions GetAssociationStatus() GetAuthenticationMode() Call this function to obtain the radios current authentication mode. GetBSSID() GetDiversity() Call this function to get the current link speed of the 802.11b/g radio. GetLinkSpeed() GetMac() GetNetworkMode() Call this function to get the current Network Mode (SSID) for the 802.11b/g radio. GetNetworkType() GetSSID() GetPowerMode() GetRSSI() Call this function to get the current RSSI (Radio Signal Strength Indicator), in Dbm. GetTXPower() Call this function to get the current transmit power of the radio. Call this to get the current state of the radios WEP and encryption levels. GetWepStatus() GetRadioIpAddress() Call this to get information about the current CCX status of the adapter. GetCCXStatus() Set Information Functions AddWep() Enables or disables WEP encryption on the radio (TRUE/FALSE). EnableWep() EncryptionStatus() Call this function to set the desired encryption status. Call this with a key index of 0-3 to remove the WEP key at that index. RemoveWep() SetAuthenticationMode() Call this function to set the desired authentication mode. SetChannel() SetNetworkMode() Call this function to set the desired Network Mode. Call this function to set the desired power mode. SetPowerMode() SetSSID() Call this function to set the desired mixed cell mode. SetCCXStatus() Call this function to set the desired CCX / Network EAP status. SetMixedCellMode() Helper Functions ConfigureProfile() Call this function to set the desired supplicant logging mode. EnableSuppLogging() EnableZeroConfig() Call this to determine whether DHCP is enabled on the current adapter. GetCurrentDriverName() Call this function to populate the TCHAR array with the driver name. isDHCPEnabled() isOrinoco() Call this function to determine whether the current radio is an ORiNOCO, Lucent, or WaveLAN radio. Call this function to determine whether Zero Config is currently enabled. isSupplicantRunning() Call this function to determine whether the security supplicant is running. RenewDHCP() Call this to force a DHCP renewal on the current network adapter. ResetRadioToSystemSave() Call this function to force the radio to reset to the last desired active profile. StartScanList() StartSupplicant() Call this to start the supplicant service if it is installed on the system. Call this function to switch between available packet drivers on the system. StopSupplicant() Call this function to stop the supplicant service. Notifications NLEDGetDeviceInfo NLEDSetDevice Reboot Functions Reprogramming the 751G Keypad Key Values How Key Values Are Stored in Registry Change Notification Advanced Keypad Remapping Scan Codes Sample View of Registry Keys See the registry on your device for the latest 751G key mappings. Scan Codes (continued) Page Updating the System Software Using a Storage Card to Upgrade the Computer Using the SmartSystems Console to Upgrade the Computer Troubleshooting Your Computer Problems While Configuring the Computer Problems with Wireless Connectivity Problems While Configuring 802.1x Security Problems While Scanning Bar Codes Cleaning the Scanner Page 5 802.11b/g Communications Remote Access (Modems) Connecting to an Internet Service Provider Page Page Connecting to Work Ending a Connection Configuring Security Loading Certificates Wireless Networks Encryption Key Management Protocols Authentication Choosing Between Microsoft and Funk Security Configuring Funk Security Using WPA Security Page Using 802.1x Authentication Page Using Static WEP Security Configuring Microsoft Security SmartSystems Foundation Page Page Page Page Page Page Page Page Page Page Page Page Page Page *961-054-036C*