Метод ITRendezvous::CreateDirectory (rend.h)
[Элементы управления и интерфейсы конференц-связи с IP-телефонией рандеву недоступны для использования в Windows Vista, Windows Server 2008 и последующих версиях операционной системы. Api клиента RTC предоставляет аналогичные функциональные возможности.]
Метод CreateDirectory создает объект ITDirectory, соответствующий каталогу с заданным типом и именем.
Синтаксис
HRESULT CreateDirectory(
[in] DIRECTORY_TYPE DirectoryType,
[in] BSTR pName,
[out] ITDirectory **ppDir
);
Параметры
[in] DirectoryType
Тип каталога. См . DIRECTORY_TYPE.
[in] pName
Указатель на BSTR , содержащий имя создаваемого каталога.
[out] ppDir
Указатель на получение объекта ITDirectory указанного выше типа.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
| Значение | Значение |
|---|---|
|
Метод успешно выполнен. |
|
Для выполнения операции недостаточно памяти. |
|
Параметр pName или ppDir является недопустимым указателем. |
|
Недопустимый параметр DirectoryType . |
Комментарии
Для каталогов типа DT_NTDS pName игнорируется, так как Rendezvous поддерживает использование только локального контроллера домена (DC).
Приложение должно использовать SysAllocString для выделения памяти для параметра pName и использовать SysFreeString , чтобы освободить память, когда переменная больше не нужна.
TAPI вызывает метод AddRef в интерфейсе ITDirectory , возвращенном методом ITRendezvous::CreateDirectory. Приложение должно вызвать Release в интерфейсе ITDirectory , чтобы освободить связанные с ним ресурсы.
Эта функция может отправлять данные по сети в незашифрованном виде; Таким образом, кто-то прослушивает в сети, возможно, сможет прочитать данные. Перед использованием этого метода следует учитывать риск безопасности при отправке данных в виде чистого текста.
Требования
| Целевая платформа | Windows |
| Header | rend.h |
| DLL | Rend.dll |