Platform SDK: TAPI

ITLocationInfo::get_PreferredCardID

Gets the preferred calling card identifier for dialing from the current location.

HRESULT get_PreferredCardID(
  long *plCardID
);

Parameters

plCardID
[out, retval] Calling card ID.

Return Values

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

Remarks

The value that this method returns corresponds to the dwPreferredCardID member 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, lineGetTranslateCaps, LINELOCATIONENTRY