Método ITDirectory::get_DirectoryObjects (rend.h)

Artículo
03/01/2024

[Los controles e interfaces de conferencia de telefonía IP de encuentro 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 get_DirectoryObjects obtiene la colección de objetos de un directorio determinado que coincide con determinados criterios. Este método realiza la misma función que EnumerateDirectoryObjects , pero lo usa Visual Basic y otros lenguajes de scripting.

Sintaxis

HRESULT get_DirectoryObjects(
  [in]  DIRECTORY_OBJECT_TYPE DirectoryObjectType,
  [in]  BSTR                  pName,
  [out] VARIANT               *pVariant
);

Parámetros

[in] DirectoryObjectType

El DIRECTORY_OBJECT_TYPE criterios para el objeto deseado.

[in] pName

Puntero a un BSTR que contiene el nombre completo o parcial del objeto. Se admite el carácter comodín "*".

[out] pVariant

Puntero a un VARIANT que recibe una ITCollection de objetos ITDirectoryObject en el servidor que coinciden con la descripción.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Significado
S_OK	El método se realizó correctamente.
RND_NOT_CONNECTED	El método ITDirectory::Connect no se ha invocado o no se ha realizado correctamente.
E_NOTIMPL	Este método no se implementa.

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 ITDirectory::get_DirectoryObjects. La aplicación debe llamar a Release en la interfaz ITDirectoryObject para liberar recursos asociados a él.