Platform SDK: TAPI

ITLocationInfo::get_LocationName

Gets location name.

HRESULT get_LocationName(
  BSTR *ppLocationName 
);

Parameters

ppLocationName
[out, retval] Pointer to BSTR representation of location name.

Return Values

Value Meaning
S_OK Method succeeded.
E_POINTER The ppLocationName parameter is not a valid pointer.
E_OUTOFMEMORY Insufficient memory exists to perform the operation.

Remarks

The application must use SysFreeString to free the memory allocated for the ppLocationName parameter.

The value that this method returns corresponds to the dwLocationNameSize and dwLocationNameOffset members of TAPI 2's LINELOCATIONENTRY structure.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Tapi3.h.
  Library: Use T3iid.lib.

See Also

ITLocationInfo, LINELOCATIONENTRY, lineGetTranslateCaps