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
S_OK	O método foi bem-sucedido.
E_POINTER	O chamador passou um argumento de ponteiro inválido.
E_OUTOFMEMORY	Não existe memória suficiente para criar os objetos necessários.
E_INVALIDARG	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

Confira também

IMcastAddressAllocation