Retrieves the network registration state.
DWORD GetRegisterStatus(
REGISTRATIONINFO *pdwStatus
);
Parameters
pdwStatus
[out] The network registration status is returned in pdwStatus. Possible values are defined in REGISTRATIONINFO:
REGSTATUS_UNKNOWN Registration is unknown.
REGSTATUS_DENIED Registration denied.
REGSTATUS_UNREGISTERED Not registered.
REGSTATUS_ATTEMPTING Attempting to register.
REGSTATUS_HOME Registered at home.
REGSTATUS_ROAM Registered for roam.
REGSTATUS_DIGITAL Registered for digital service.
REGSTATUS_ANALOG Registered for analog service.
Return values
Zero indicates success. A negative error number indicates that an error occurred. For additional error information, enable the library debug mode.
Remarks
The GetRegisterStatus function is synchronous.
It can be used to obtain the network registration status as it was when calling this function.
Note that the HARDWARE_EVENT_REGISTERSTATUS is also provided by tpfnCallback dwEvent when the network registration state changes.
Requirements
OS Versions: Windows CE 1.0 and later.
Header: dyntapi.h.
Dll Library: dyntapidll.dll.