Método IMcastAddressAllocation::RequestAddress (mdhcp.h)
[Controles e interfaces de conferência de telefonia de IP de reunião não estão disponíveis para uso no Windows Vista, Windows Server 2008 e versões subsequentes do sistema operacional. A API do Cliente RTC fornece funcionalidade semelhante.]
O método RequestAddress obtém uma nova concessão para um ou mais endereços multicast. O método EnumerateScopes ou get_Scopes deve ser chamado primeiro.
Sintaxe
HRESULT RequestAddress(
[in] IMcastScope *pScope,
[in] DATE LeaseStartTime,
[in] DATE LeaseStopTime,
[in] long NumAddresses,
[out] IMcastLeaseInfo **ppLeaseResponse
);
Parâmetros
[in] pScope
Identifica o escopo multicast do qual o aplicativo precisa de um endereço. O aplicativo primeiro chama get_Scopes ou EnumerateScopes para obter uma lista de escopos disponíveis.
[in] LeaseStartTime
Tempo solicitado para que a concessão nesses endereços seja iniciada. A hora de início que é realmente concedida pode ser diferente.
[in] LeaseStopTime
Tempo solicitado para que a concessão nesses endereços pare. O tempo de parada que é realmente concedido pode ser diferente.
[in] NumAddresses
O número de endereços solicitados. Menos endereços podem realmente ser concedidos.
[out] ppLeaseResponse
Ponteiro para um ponteiro de interface que será definido para apontar para um novo objeto IMcastLeaseInfo . Essa interface pode ser usada para descobrir os atributos reais da concessão concedida. Consulte IMcastScope para obter mais informações.
Valor retornado
Esse método pode retornar um desses valores.
| Valor | Significado |
|---|---|
|
O método foi bem-sucedido. |
|
O chamador passou um argumento de ponteiro inválido. |
|
Não existe memória suficiente para criar os objetos necessários. |
|
O tempo de parada solicitado é anterior ao tempo de parada solicitado. |
Comentários
Embora essas interfaces COM e sua implementação deem suporte à alocação de vários endereços por vez, no momento, não há suporte para várias alocações nas chamadas de função subjacentes. Talvez seja necessário usar um loop para alocação de vários endereços.
O TAPI chama o método AddRef na interface IMcastLeaseInfo retornada por IMcastAddressAllocation::RequestAddress. O aplicativo deve chamar Release na interface IMcastLeaseInfo para liberar recursos associados a ele.
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | mdhcp.h |
| Biblioteca | Uuid.lib |
| DLL | Mdhcp.dll |