ITDirectoryObjectUser::p ut_IPPhonePrimary 메서드(rend.h)

[랑데부 IP 전화 회의 컨트롤 및 인터페이스는 Windows Vista, Windows Server 2008 및 후속 버전의 운영 체제에서 사용할 수 없습니다. RTC 클라이언트 API는 유사한 기능을 제공합니다.]

put_IPPhonePrimary 메서드는 컴퓨터의 이름을 사용자의 기본 IP 휴대폰으로 설정합니다.

구문

HRESULT put_IPPhonePrimary(
  [in] BSTR pName
);

매개 변수

[in] pName

사용자의 IP 기본 휴대폰의 BSTR 표현에 대한 포인터입니다.

반환 값

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

반환 코드 Description
S_OK
메서드가 정상적으로 실행되었습니다.
E_POINTER
잘못된 포인터입니다.

설명

이 메서드는 이후에 디렉터리에 추가되는 새 개체에서만 사용할 수 있습니다. 애플리케이션이 기존 사용자 개체의 IP 휴대폰을 수정하려는 경우 서버에서 개체를 열거하여 이전 IP 휴대폰이 있는지 확인해야 합니다. 이는 TAPI 3 애플리케이션이 하나 이상의 다른 컴퓨터에서 실행 중임을 의미합니다. 로컬 컴퓨터의 애플리케이션에는 다른 애플리케이션이 여전히 실행 중인지 여부에 대한 정보가 없습니다. 따라서 기존 사용자 개체에서 IP Phone을 변경하는 것은 애플리케이션의 위치가 아닙니다.

기존 사용자의 IP 휴대폰을 수정하려면 사용자를 삭제하고 다시 추가해야 합니다.

애플리케이션은 SysAllocString을 사용하여 pName 매개 변수에 대한 메모리를 할당하고, 변수가 더 이상 필요하지 않을 때 SysFreeString을 사용하여 메모리를 해제해야 합니다.

이 함수는 암호화되지 않은 형식으로 와이어를 통해 데이터를 보낼 수 있습니다. 따라서 네트워크에서 도청하는 사용자가 데이터를 읽을 수 있습니다. 이 메서드를 사용하기 전에 데이터를 명확한 텍스트로 보내는 보안 위험을 고려해야 합니다.

요구 사항

요구 사항
대상 플랫폼 Windows
헤더 rend.h
DLL Rend.dll

추가 정보

ITDirectoryObjectUser

ITDirectoryObjectUser::get_IPPhonePrimary