ITParticipant::get_ParticipantTypedInfo method

[get_ParticipantTypedInfo is not available for use in Windows Vista, Windows Server 2008, and subsequent versions of the operating system. The RTC Client API provides similar functionality.]

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

Syntax

HRESULT get_ParticipantTypedInfo(
  [in]  PARTICIPANT_TYPED_INFO InfoType,
  [out] BSTR                   *ppInfo
);

Parameters

InfoType [in]

PARTICIPANT_TYPED_INFO descriptor of the type of information needed.

ppInfo [out]

Pointer to BSTR representation of the information needed.

Return value

This method can return one of these values.

Return code Description
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

Requirement Value
TAPI version
Requires TAPI 3.0 or later
Header
Ipmsp.h
Library
Uuid.lib
DLL
Tapi3.dll

See also

ITParticipant

PARTICIPANT_TYPED_INFO

media types