SHGetEmergencyCallList (Compact 7)

  • Article

3/12/2014

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 Compact-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 Compact 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

See Also

Reference

AYGShell Functions