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
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.

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

Confira também

IMcastAddressAllocation