SHGetEmergencyCallList
A version of this page is also available for
4/8/2010
For Windows Mobile devices, the SHGetEmergencyCallList function gets a list of emergency numbers. The caller needs to allocate adequate buffer space to store phone numbers and pass a pointer to it as pwszBuffer.
Note
This function is not implemented for Windows Embedded CE-based devices. It is provided as a stub in the operating system (OS) for application compatibility. This function will return E_NOTIMPL for Windows Embedded CE OS versions.
Syntax
HRESULT SHGetEmergencyCallList(
TCHAR* pwszBuffer,
UINT uLenBuf
);
Parameters
- pwszBuffer
Reference to the buffer that receives the emergency call list.
- uLenBuf
Length of the buffer, in TCHARs.
Return Value
NOERROR indicates success. E_INVALIDARG indicates inadequate buffer space.
Remarks
Emergency numbers are those that can be dialed any time, even when the device is locked. Upon successful return of this API, pwszBuffer will contain a list of the emergency numbers that are supported, which will be separated by NULL ('\0') characters. The list is terminated by two NULL characters.
Requirements
| Header | aygshell.h |
| Library | aygshell.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Pocket PC 2002 and later, Smartphone 2002 and later |