Platform SDK: TAPI

ITParticipant::get_ParticipantTypedInfo

The get_ParticipantTypedInfo method gets a BSTR representation of the type of information needed, such as PTI_EMAILADDRESS.

HRESULT get_ParticipantTypedInfo(
  PARTICIPANT_TYPED_INFO InfoType,
  BSTR *ppInfo
);

Parameters

InfoType
[in] PARTICIPANT_TYPED_INFO descriptor of the type of information needed.
ppInfo
[out, retval] Pointer to BSTR representation of the information needed.

Return Values

Value Meaning
S_OK Method succeeded.
E_FAIL Storage of information into ppInfo failed.
E_INVALIDARG The InfoType parameter is not valid.
E_POINTER The ppInfo parameter is not a valid pointer.
TAPI_E_NOITEM TAPI has no information on the specified type.
E_OUTOFMEMORY Insufficient memory exists to perform the operation.

Remarks

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

Requirements

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

See Also

ITParticipant, PARTICIPANT_TYPED_INFO, media types