Método IMcastAddressAllocation::CreateLeaseInfo (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 CreateLeaseInfo cria um objeto de informações de concessão para uma chamada subsequente para RenewAddress ou ReleaseAddress.
Sintaxe
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
A hora de início da concessão.
[in] LeaseStopTime
O tempo de parada da concessão.
[in] dwNumAddresses
O número de endereços associados à concessão.
[in] ppAddresses
Uma matriz de ponteiros LPWSTR de tamanho dwNumAddresses. Cada LPWSTR é um endereço IP versão 4 na notação quad pontilhada (por exemplo, 10.111.222.111).
[in] pRequestID
Um LPWSTR especificando a ID da solicitação para a solicitação original. Isso é obtido chamando IMcastLeaseInfo::get_RequestID no objeto de informações de concessão correspondente à solicitação original. A ID da solicitação deve ser salva no armazenamento persistente entre as execuções do programa de aplicativo. Se você estiver renovando ou liberando uma concessão que foi solicitada durante a mesma execução do aplicativo, não terá motivos para usar CreateLeaseInfo; basta passar o ponteiro IMcastLeaseInfo existente para RenewAddress ou ReleaseAddress.
[in] pServerAddress
Especifica o endereço do servidor.
[out] ppReleaseRequest
Ponteiro para a interface IMcastLeaseInfo criada.
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. |
Comentários
O TAPI chama o método AddRef na interface IMcastLeaseInfo retornada por IMcastAddressAllocation::CreateLeaseInfo. O aplicativo deve chamar Release na interface IMcastLeaseInfo para liberar recursos associados a ele.
Essa função pode enviar dados pela transmissão em formato não criptografado; portanto, alguém escutando na rede pode ser capaz de ler os dados. O risco de segurança de enviar os dados em texto não criptografado deve ser considerado antes de usar esse método.
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | mdhcp.h |
| Biblioteca | Uuid.lib |
| DLL | Mdhcp.dll |