Método ITRendezvous::CreateDirectory (rend.h)
[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 CreateDirectory crea un objeto ITDirectory correspondiente a un directorio del tipo y el nombre especificados.
Sintaxis
HRESULT CreateDirectory(
[in] DIRECTORY_TYPE DirectoryType,
[in] BSTR pName,
[out] ITDirectory **ppDir
);
Parámetros
[in] DirectoryType
Tipo del directorio. Consulte DIRECTORY_TYPE.
[in] pName
Puntero a un BSTR que contiene el nombre del directorio que se va a crear.
[out] ppDir
Puntero para recibir un objeto ITDirectory del tipo especificado anteriormente.
Valor devuelto
Este método puede devolver uno de estos valores.
| Valor | Significado |
|---|---|
|
El método se realizó correctamente. |
|
Existe memoria insuficiente para realizar la operación. |
|
El parámetro pName o ppDir es un puntero no válido. |
|
El parámetro DirectoryType no es válido. |
Comentarios
En el caso de los directorios de tipo DT_NTDS, pName se omite porque Rendezvous solo admite el uso del controlador de dominio local (DC).
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 ITDirectory devuelta por ITRendezvous::CreateDirectory. La aplicación debe llamar a Release en la interfaz ITDirectory para liberar recursos asociados a él.
Esta función puede enviar datos a través de la conexión en forma sin cifrar; por lo tanto, es posible que alguien intercepte en la red pueda leer los datos. El riesgo de seguridad de enviar los datos en texto no cifrado debe tenerse en cuenta antes de usar este método.
Requisitos
| Plataforma de destino | Windows |
| Encabezado | rend.h |
| Archivo DLL | Rend.dll |