다음을 통해 공유


IH323LineEx::SetAlias 메서드

[SetAlias 는 Windows Vista, Windows Server 2008 및 이후 버전의 운영 체제에서 사용할 수 없습니다. RTC 클라이언트 API는 유사한 기능을 제공합니다.]

SetAlias 메서드는 주소에 대한 기본 H.323 별칭을 구성합니다. 이 별칭은 상대방이 이 파티의 이름을 알 수 있도록 H.323 통화 설정 교환에서 사용됩니다.

이 메서드를 두 번째로 호출하면 이전 별칭을 덮어씁니다.

이 인터페이스에 설정된 별칭은 TSP가 적절한 별칭을 찾을 수 있는 다른 방법이 없는 경우에만 사용됩니다. 나중에 게이트키퍼 지원이 TSP에 추가되면 게이트키퍼에 등록되거나 게이트키퍼가 할당한 별칭이 이 메서드를 통해 설정된 모든 항목을 재정의합니다.

구문

HRESULT SetAlias(
  [in] WCHAR *strAlias,
  [in] DWORD dwLength
);

매개 변수

strAlias [in]

유니코드에서 사용할 별칭입니다. Null 종료는 필요하지 않습니다.

dwLength [in]

null 종결자를 포함하여 문자 수의 별칭 이름 길이입니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드 Description
S_OK
메서드가 정상적으로 실행되었습니다.
E_POINTER
dwLength에 표시된 문자 수가 strAlias 매개 변수의 실제 문자 수를 초과합니다.

요구 사항

요구 사항
TAPI 버전
TAPI 3.0 이상이 필요합니다.
헤더
H323priv.h
라이브러리
Uuid.lib
DLL
Tapi3.dll