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

Artigo
08/25/2023

[Controles e interfaces de conferência de telefonia ip de encontro 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 CreateDirectory cria um objeto ITDirectory correspondente a um diretório do tipo e nome fornecidos.

Sintaxe

HRESULT CreateDirectory(
  [in]  DIRECTORY_TYPE DirectoryType,
  [in]  BSTR           pName,
  [out] ITDirectory    **ppDir
);

Parâmetros

[in] DirectoryType

O tipo do diretório. Consulte DIRECTORY_TYPE.

[in] pName

Ponteiro para um BSTR que contém o nome do diretório a ser criado.

[out] ppDir

Ponteiro para receber um objeto ITDirectory do tipo especificado acima.

Valor retornado

Esse método pode retornar um desses valores.

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

Comentários

Para diretórios do tipo DT_NTDS, pName é ignorado porque o Rendezvous dá suporte ao uso apenas do CONTROLADOR de domínio local (DC).

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

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