Método IMcastAddressAllocation::CreateLeaseInfoFromVariant (mdhcp.h)
[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 CreateLeaseInfoFromVariant crea un objeto de información de concesión para una llamada posterior a RenewAddress o ReleaseAddress. Este método es similar a CreateLeaseInfo , pero lo usan los lenguajes de cliente de Automation, como Visual Basic.
Sintaxis
HRESULT CreateLeaseInfoFromVariant(
[in] DATE LeaseStartTime,
[in] DATE LeaseStopTime,
[in] VARIANT vAddresses,
[in] BSTR pRequestID,
[in] BSTR pServerAddress,
[out] IMcastLeaseInfo **ppReleaseRequest
);
Parámetros
[in] LeaseStartTime
Hora de inicio de la concesión.
[in] LeaseStopTime
Hora de detención de la concesión.
[in] vAddresses
Variant que contiene una SAFEARRAY de cadenas BSTR. Cada BSTR es una dirección IP versión 4 en notación cuadrátil de puntos (por ejemplo, 10.111.222.111).
[in] pRequestID
Puntero a un BSTR que especifica el identificador de solicitud para la solicitud original. Esto se obtiene llamando a IMcastLeaseInfo::get_RequestID en el objeto de información de concesión correspondiente a la solicitud original. El identificador de solicitud debe guardarse en el almacenamiento persistente entre las ejecuciones del programa de aplicación. Si va a renovar o liberar una concesión solicitada durante la misma ejecución de la aplicación, no tiene ninguna razón para usar CreateLeaseInfo; simplemente pase el puntero IMcastLeaseInfo existente a RenewAddress o ReleaseAddress.
[in] pServerAddress
Puntero a un BSTR que especifica la dirección del servidor.
[out] ppReleaseRequest
Puntero a la interfaz IMcastLeaseInfo creada.
Valor devuelto
Este método puede devolver uno de estos valores.
| Valor | Significado |
|---|---|
|
El método se realizó correctamente. |
|
El autor de la llamada pasó en un argumento de puntero no válido. |
|
No existe suficiente memoria para crear los objetos necesarios. |
Comentarios
La aplicación debe usar SysAllocString para asignar memoria para los parámetros pRequestID y pServerAddress . La aplicación debe usar SysFreeString para liberar la memoria cuando las variables ya no sean necesarias.
TAPI llama al método AddRef en la interfaz IMcastLeaseInfo devuelta por IMcastAddressAllocation::CreateLeaseInfoFromVariant. La aplicación debe llamar a Release en la interfaz IMcastLeaseInfo 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, 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
| Plataforma de destino | Windows |
| Encabezado | mdhcp.h |
| Library | Uuid.lib |
| Archivo DLL | Mdhcp.dll |