Поделиться через


Метод ITRendezvous::CreateDirectoryObject (rend.h)

[Элементы управления и интерфейсы конференц-связи с IP-телефонией для встреч недоступны для использования в Windows Vista, Windows Server 2008 и последующих версиях операционной системы. Api клиента RTC предоставляет аналогичные функции.]

Метод 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 вызывает метод AddRef в интерфейсе ITDirectoryObject , возвращенном ITRendezvous::CreateDirectoryObject. Приложение должно вызывать Release в интерфейсе ITDirectoryObject , чтобы освободить связанные с ним ресурсы.

Эта функция может отправлять данные по сети в незашифрованном виде; Таким образом, кто-то прослушивает в сети, может быть в состоянии прочитать данные. Перед использованием этого метода следует учитывать риск безопасности при отправке данных в виде чистого текста.

Требования

Требование Значение
Целевая платформа Windows
Header rend.h
DLL Rend.dll

См. также раздел

DIRECTORY_OBJECT_TYPE

ITDirectoryObject

ITRendezvous