Método IMcastAddressAllocation::CreateLeaseInfo (mdhcp.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 CreateLeaseInfo crea un objeto de información de concesión para una llamada posterior a RenewAddress o ReleaseAddress.

Sintaxis

HRESULT CreateLeaseInfo(
  [in]  DATE            LeaseStartTime,
  [in]  DATE            LeaseStopTime,
  [in]  DWORD           dwNumAddresses,
  [in]  LPWSTR          *ppAddresses,
  [in]  LPWSTR          pRequestID,
  [in]  LPWSTR          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] dwNumAddresses

Número de direcciones asociadas a la concesión.

[in] ppAddresses

Matriz de punteros LPWSTR de tamaño dwNumAddresses. Cada LPWSTR es una dirección IP versión 4 en notación cuadrimétrica de puntos (por ejemplo, 10.111.222.111).

[in] pRequestID

LpWSTR 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 está renovando o liberando 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

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
S_OK	El método se realizó correctamente.
E_POINTER	El llamador pasó en un argumento de puntero no válido.
E_OUTOFMEMORY	No existe suficiente memoria para crear los objetos necesarios.

Comentarios

TAPI llama al método AddRef en la interfaz IMcastLeaseInfo devuelta por IMcastAddressAllocation::CreateLeaseInfo. 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, 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	mdhcp.h
Library	Uuid.lib
Archivo DLL	Mdhcp.dll

Consulte también

IMcastAddressAllocation