Ioctl_Hal_Itc_Write_Sysparm - Intermec 700 Series User Manual

Chapter 7 — Programming

IOCTL_HAL_ITC_WRITE_SYSPARM

296
Describes and enables the registry save location.
Usage
#include "oemioctl.h"
Syntax
BOOL KernelIoControl( IOCTL_HAL_ITC_WRITE_SYSPARM,LPVOID
lpInBuf,DWORD nInBufSize, LPVOID lpOutBuf, DWORD
nOutBufSize, LPDWORD lpBytesReturned );
Parameters
S lpInBuf
A single byte that may be one of the id values. See "ID Field Values" be-
low.
S nInBufSize
Must be set to the size of the lpInBuf in bytes.
S lpOutBuf
Must point to a buffer large enough to hold the data to be written to
the non-volatile data store.
S nOutBufSize
The size of lpOutBuf in bytes.
S lpBytesReturned
The number of bytes returned by the function.
Return Values
Returns TRUE if function succeeds. Returns FALSE if the function fails.
GetLastError() may be used to get the error value. Either
ERROR_INVALID_PARAMETER or
ERROR_INSUFFICIENT_BUFFER may be returned when this function
is used to get the error.
ID Field Values
The id field of lpInBuf may be one of the following values:
S ITC_REGISTRY_LOCATION
This IOCTL sets the default location for where to write the registry
when RegFlushKey() is called by an application. The registry may be
saved to Flash, a CompactFlash storage card or a Secure Digital storage
card. lpOutBuf must point to a buffer that contains a byte value of "1"
for the CompactFlash card or "2" for the Secure Digital card to specify
the location.
S ITC_REGISTRY_SAVE_ENABLE
This function enables or disables the save registry to non-volatile media
feature of the RegFlushKey() function. lpOutBuf must be set to zero
(FALSE) if the feature is to be disabled or one (TRUE) if the feature is
to be enabled.
700 Series Color Mobile Computer User's Manual