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

아티클
08/25/2023

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

CreateDirectory 메서드는 지정된 형식 및 이름의 디렉터리에 해당하는 ITDirectory 개체를 만듭니다.

구문

HRESULT CreateDirectory(
  [in]  DIRECTORY_TYPE DirectoryType,
  [in]  BSTR           pName,
  [out] ITDirectory    **ppDir
);

매개 변수

[in] DirectoryType

디렉터리의 형식입니다. DIRECTORY_TYPE 참조하세요.

[in] pName

만들 디렉터리의 이름을 포함하는 BSTR 에 대한 포인터입니다.

[out] ppDir

위에 지정된 형식의 ITDirectory 개체를 수신하는 포인터입니다.

반환 값

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

값	의미
S_OK	메서드가 정상적으로 실행되었습니다.
E_OUTOFMEMORY	작업을 수행하기 위한 메모리가 부족합니다.
E_POINTER	pName 또는 ppDir 매개 변수가 잘못된 포인터입니다.
E_INVALIDARG	DirectoryType 매개 변수가 잘못되었습니다.

설명

DT_NTDS 형식의 디렉터리에서는 Rendezvous가 로컬 DC(도메인 컨트롤러)만 사용할 수 있으므로 pName 이 무시됩니다.

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

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

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