Método IMcastAddressAllocation::RequestAddress (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 RequestAddress obtiene una nueva concesión para una o varias direcciones de multidifusión. Primero se debe llamar al método EnumerateScopes o get_Scopes .

Sintaxis

HRESULT RequestAddress(
  [in]  IMcastScope     *pScope,
  [in]  DATE            LeaseStartTime,
  [in]  DATE            LeaseStopTime,
  [in]  long            NumAddresses,
  [out] IMcastLeaseInfo **ppLeaseResponse
);

Parámetros

[in] pScope

Identifica el ámbito de multidifusión desde el que la aplicación necesita una dirección. La aplicación llama primero a get_Scopes o EnumerateScopes para obtener una lista de ámbitos disponibles.

[in] LeaseStartTime

Hora solicitada para que se inicie la concesión en estas direcciones. La hora de inicio que se concede realmente puede ser diferente.

[in] LeaseStopTime

Tiempo solicitado para que se detenga la concesión en estas direcciones. El tiempo de detención que se concede realmente puede ser diferente.

[in] NumAddresses

Número de direcciones solicitadas. Es posible que se concedan menos direcciones.

[out] ppLeaseResponse

Puntero a un puntero de interfaz que se establecerá para que apunte a un nuevo objeto IMcastLeaseInfo . A continuación, esta interfaz se puede usar para detectar los atributos reales de la concesión concedida. Consulte IMcastScope para obtener más información.

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.
E_INVALIDARG	La hora de detención solicitada es anterior a la hora de detención solicitada.

Comentarios

Aunque estas interfaces COM y su implementación admiten la asignación de varias direcciones a la vez, las llamadas de función subyacentes no admiten actualmente varias asignaciones. Es posible que tenga que usar un bucle para la asignación de varias direcciones.

TAPI llama al método AddRef en la interfaz IMcastLeaseInfo devuelta por IMcastAddressAllocation::RequestAddress. La aplicación debe llamar a Release en la interfaz IMcastLeaseInfo para liberar recursos asociados a él.

Requisitos

Plataforma de destino	Windows
Encabezado	mdhcp.h
Library	Uuid.lib
Archivo DLL	Mdhcp.dll

Consulte también

IMcastAddressAllocation