Método ITRendezvous::CreateDirectory (rend.h)
[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 |
|---|---|
|
O método foi bem-sucedido. |
|
Há memória insuficiente para executar a operação. |
|
O parâmetro pName ou ppDir é um ponteiro inválido. |
|
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.
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | rend.h |
| DLL | Rend.dll |