ITMedia::p 안 _ MediaTitle 메서드ITMedia::put_MediaTitle method

[ Windows Vista, Windows Server 2008 및 이후 버전의 운영 체제에서는 랑 데 부 IP 전화 통신 회의 컨트롤 및 인터페이스를 사용할 수 없습니다.[ Rendezvous IP Telephony Conferencing controls and interfaces are not available for use in Windows Vista, Windows Server 2008, and subsequent versions of the operating system. RTC 클라이언트 API는 비슷한 기능을 제공 합니다.]The RTC Client API provides similar functionality.]

Put _ MediaTitle 메서드는 응용 프로그램이 정보나 표시 목적으로 사용할 수 있는 미디어의 텍스트 제목을 설정 합니다.The put_MediaTitle method sets a textual title for the media that the application can use for informational or display purposes. 문자 집합이 ASCII 인 경우이 문자열을 변환할 수 있는 ASCII 문자열 이어야 합니다.This must be an ASCII convertible string if the character set is ASCII. 그렇지 않으면 모든 BSTR 문자열을 사용할 수 있습니다.Otherwise, it can be any BSTR string.

구문Syntax

HRESULT put_MediaTitle(
  [in] BSTR pMediaTitle
);

매개 변수Parameters

pMediaTitle [ 진행]pMediaTitle [in]

미디어의 제목을 포함 하는 BSTR 에 대 한 포인터입니다.Pointer to a BSTR containing the title of the media.

반환 값Return value

이 메서드는 다음 값 중 하나를 반환할 수 있습니다.This method can return one of these values.

반환 코드Return code 설명Description
S _ 양호
S_OK
메서드가 정상적으로 실행되었습니다.Method succeeded.
E _ 포인터
E_POINTER
PMediaTitle 매개 변수는 올바른 포인터가 아닙니다.The pMediaTitle parameter is not a valid pointer.
E _ INVALIDARG
E_INVALIDARG
PMediaTitle 매개 변수가 잘못 되었습니다.The pMediaTitle parameter is not valid.
E _ OUTOFMEMORY
E_OUTOFMEMORY
메모리가 부족 하 여 작업을 수행할 수 없습니다.Insufficient memory exists to perform the operation.
E _ 실패
E_FAIL
알 수 없는 오류입니다.Unspecified error.
E _ NOTIMPL
E_NOTIMPL
이 메서드는 아직 구현되지 않았습니다.This method is not yet implemented.

설명Remarks

응용 프로그램은 SysAllocString 를 사용 하 여 pMediaTitle 매개 변수에 대해 메모리를 할당 해야 하며, 변수가 더 이상 필요 하지 않을 때 sysfreestring 을 사용 하 여 메모리를 해제 해야 합니다.The application must use SysAllocString to allocate memory for the pMediaTitle parameter and use SysFreeString to free the memory when the variable is no longer needed.

이 함수는 암호화 되지 않은 형식으로 네트워크를 통해 데이터를 보낼 수 있습니다. 따라서 네트워크에서 도청 하는 사람이 데이터를 읽을 수 있습니다.This function may send data over the wire in unencrypted form; therefore, someone eavesdropping on the network may be able to read the data. 이 메서드를 사용 하기 전에 데이터를 일반 텍스트로 전송 하는 보안 위험을 고려해 야 합니다.The security risk of sending the data in clear text should be considered before using this method.

요구 사항Requirements

요구 사항Requirement Value
TAPI 버전TAPI version
TAPI 3.0 이상 필요Requires TAPI 3.0 or later
헤더Header
Sdpblb.h
Sdpblb.h
라이브러리Library
Uuid
Uuid.lib
DLLDLL
Sdpblb.dll
Sdpblb.dll

참고 항목See also

ITMediaITMedia

ITMedia:: get _ MediaTitleITMedia::get_MediaTitle