Compartilhar via


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

[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 CreateDirectoryObject cria um novo objeto ITDirectoryObject .

Sintaxe

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

Parâmetros

[in] DirectoryObjectType

O tipo do objeto. Consulte DIRECTORY_OBJECT_TYPE.

[in] pName

Ponteiro para um BSTR que contém o nome do objeto.

[out] ppDirectoryObject

Ponteiro para receber o ponteiro de interface para o objeto ITDirectoryObject recém-criado.

Retornar valor

Esse método pode retornar um desses valores.

Valor Significado
S_OK
O método foi bem-sucedido.
E_INVALIDARG
O parâmetro DirectoryObjectType não é válido.
E_OUTOFMEMORY
Existe memória insuficiente para executar a operação.
E_POINTER
O ponteiro é inválido.

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 ITRendezvous::CreateDirectoryObject. O aplicativo deve chamar Release na interface ITDirectoryObject para liberar recursos associados a ele.

Essa função pode enviar dados pela transmissão em formato não criptografado; portanto, alguém escutando na rede pode ser capaz de ler os dados. O risco de segurança de enviar os dados em texto não criptografado deve ser considerado antes de usar esse método.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho rend.h
DLL Rend.dll

Confira também

DIRECTORY_OBJECT_TYPE

ITDirectoryObject

ITRendezvous