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

Artigo
03/05/2024

[Controles e interfaces de conferência de telefonia de IP de reunião não estão disponíveis para uso no Windows Vista, Windows Server 2008 e versões subsequentes do sistema operacional. A API do Cliente RTC fornece funcionalidade semelhante.]

O método get_DirectoryObjects obtém a coleção de objetos em um determinado diretório que corresponde a determinados critérios. Esse método executa a mesma função que EnumerateDirectoryObjects , mas é usado pelo Visual Basic e outras linguagens de script.

Sintaxe

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

Parâmetros

[in] DirectoryObjectType

O DIRECTORY_OBJECT_TYPE critérios para o objeto desejado.

[in] pName

Ponteiro para um BSTR que contém o nome completo ou parcial do objeto. Há suporte para o curinga "*".

[out] pVariant

Ponteiro para um VARIANT que recebe uma ITCollection de objetos ITDirectoryObject no servidor que correspondem à descrição.

Retornar valor

Esse método pode retornar um desses valores.

Valor	Significado
S_OK	O método foi bem-sucedido.
RND_NOT_CONNECTED	O método ITDirectory::Connect não foi invocado ou não foi bem-sucedido.
E_NOTIMPL	Este método não está implementado.

Comentários

O aplicativo deve usar SysAllocString para alocar memória para o parâmetro pName e usar SysFreeString para liberar a memória quando a variável não for mais necessária.

O TAPI chama o método AddRef na interface ITDirectoryObject retornada por ITDirectory::get_DirectoryObjects. O aplicativo deve chamar Release na interface ITDirectoryObject para liberar recursos associados a ele.