Compartilhar via


SHGetEmergencyCallList

A version of this page is also available for

Windows Embedded CE 6.0 R3

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