Método ITRendezvous::CreateDirectoryObject (rend.h)

Artículo
03/05/2024

[Los controles e interfaces de conferencia de telefonía IP de Rendezvous no están disponibles para su uso en Windows Vista, Windows Server 2008 y versiones posteriores del sistema operativo. La API de cliente RTC proporciona una funcionalidad similar.]

El método CreateDirectoryObject crea un nuevo objeto ITDirectoryObject .

Sintaxis

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

Parámetros

[in] DirectoryObjectType

Tipo del objeto. Consulte DIRECTORY_OBJECT_TYPE.

[in] pName

Puntero a un BSTR que contiene el nombre del objeto.

[out] ppDirectoryObject

Puntero para recibir el puntero de interfaz para el objeto ITDirectoryObject recién creado.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Significado
S_OK	El método se realizó correctamente.
E_INVALIDARG	El parámetro DirectoryObjectType no es válido.
E_OUTOFMEMORY	Existe memoria insuficiente para realizar la operación.
E_POINTER	El puntero no es válido.

Comentarios

La aplicación debe usar SysAllocString para asignar memoria para el parámetro pName y usar SysFreeString para liberar la memoria cuando la variable ya no sea necesaria.

TAPI llama al método AddRef en la interfaz ITDirectoryObject devuelta por ITRendezvous::CreateDirectoryObject. La aplicación debe llamar a Release en la interfaz ITDirectoryObject para liberar recursos asociados a él.

Esta función puede enviar datos a través de la conexión en forma sin cifrar; por lo tanto, alguien interceptado en la red puede ser capaz de leer los datos. El riesgo de seguridad de enviar los datos en texto no cifrado debe tenerse en cuenta antes de usar este método.