BthAGGetNameByPhoneNumber
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
This function retrieves the name of the caller by using the Call Line Identification (CLI) feature defined by the Hands-Free profile specification.
Syntax
BOOL BthAGGetNameByPhoneNumber (
LPCWSTR pwszNumber,
LPWSTR pwszName
);
Parameters
- pwszNumber
[in] Specifies the phone number that CLI must identify.
- pwszName
[in/out] Receives the name of the caller identified by CLI.
Return Value
Returns FALSE if you want to use the number. If the caller name can be provided, copy the name string to pszName and return TRUE.
Remarks
The length of the name received in pszName cannot exceed MAX_DISPLAY_NAME that is defined in the file, btagpub.h
Requirements
| Header | btagpub.h |
| Library | Btagsvc_phoneext.lib |
| Windows Embedded CE | Windows CE 5.0 and later |