Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

For Windows Mobile devices, the SHGetEmergencyCallListfunction 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, pwszBufferwill 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