Compartir a través de

Método ITDirectoryObjectUser::p ut_IPPhonePrimary (rend.h)

  • Artículo

[Los controles e interfaces de conferencia de telefonía IP de Rendezvous 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 put_IPPhonePrimary establece el nombre de una máquina como teléfono IP principal para un usuario.

Sintaxis

HRESULT put_IPPhonePrimary(
  [in] BSTR pName
);

Parámetros

[in] pName

Puntero a la representación BSTR del teléfono principal IP del usuario.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 El método se realizó correctamente.
E_POINTER
 Puntero no válido.

Comentarios

Este método solo se puede usar en un nuevo objeto que se agrega posteriormente al directorio . Si una aplicación desea modificar el teléfono IP de un objeto de usuario existente, tiene que enumerar los objetos del servidor para determinar que los teléfonos IP antiguos son. Esto implica que una aplicación TAPI 3 se ejecuta en una o varias otras máquinas. La aplicación en un equipo local no tiene información sobre si esas otras aplicaciones todavía se están ejecutando. Por lo tanto, no es el lugar de la aplicación para cambiar el teléfono IP en objetos de usuario existentes.

Para modificar el teléfono IP de un usuario existente, el usuario debe eliminarse y volver a agregarse.

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.

Esta función puede enviar datos a través de la conexión en forma sin cifrar; por lo tanto, alguien interceptado en la red puede ser capaz de 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

Requisito Value
Plataforma de destino Windows
Encabezado rend.h
Archivo DLL Rend.dll

Consulte también

ITDirectoryObjectUser

ITDirectoryObjectUser::get_IPPhonePrimary