ITRendezvous::CreateDirectoryObject 메서드(rend.h)

아티클
03/01/2024

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

CreateDirectoryObject 메서드는 새 ITDirectoryObject 개체를 만듭니다.

구문

HRESULT CreateDirectoryObject(
  [in]  DIRECTORY_OBJECT_TYPE DirectoryObjectType,
  [in]  BSTR                  pName,
  [out] ITDirectoryObject     **ppDirectoryObject
);

매개 변수

[in] DirectoryObjectType

개체의 형식입니다. DIRECTORY_OBJECT_TYPE 참조하세요.

[in] pName

개체의 이름을 포함하는 BSTR 에 대한 포인터입니다.

[out] ppDirectoryObject

새로 만든 ITDirectoryObject 개체에 대한 인터페이스 포인터를 수신하는 포인터입니다.

반환 값

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

값	의미
S_OK	메서드가 정상적으로 실행되었습니다.
E_INVALIDARG	DirectoryObjectType 매개 변수가 잘못되었습니다.
E_OUTOFMEMORY	메모리가 부족하여 작업을 수행할 수 없습니다.
E_POINTER	포인터가 잘못되었습니다.

설명

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

TAPI는 ITRendezvous::CreateDirectoryObject에서 반환된 ITDirectoryObject 인터페이스에서 AddRef 메서드를 호출합니다. 애플리케이션은 ITDirectoryObject 인터페이스에서 Release를 호출하여 연결된 리소스를 해제해야 합니다.

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