Compartilhar via

Método IMcastAddressAllocation::CreateLeaseInfoFromVariant (mdhcp.h)

  • Artigo

[Controles e interfaces de conferência de telefonia ip de encontro 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 CreateLeaseInfoFromVariant cria um objeto de informações de concessão para uma chamada subsequente para RenewAddress ou ReleaseAddress. Esse método é semelhante a CreateLeaseInfo , mas é usado por linguagens de cliente de Automação, como o Visual Basic.

Sintaxe

HRESULT CreateLeaseInfoFromVariant(
  [in]  DATE            LeaseStartTime,
  [in]  DATE            LeaseStopTime,
  [in]  VARIANT         vAddresses,
  [in]  BSTR            pRequestID,
  [in]  BSTR            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] vAddresses

Uma VARIANT que contém uma SAFEARRAY de cadeias de caracteres BSTR . Cada BSTR é um endereço IP versão 4 na notação quad pontilhada (por exemplo, 10.111.222.111).

[in] pRequestID

Ponteiro para um BSTR 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

Ponteiro para um BSTR que 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 em um argumento de ponteiro inválido.
E_OUTOFMEMORY
 Não existe memória suficiente para criar os objetos necessários.

Comentários

O aplicativo deve usar SysAllocString para alocar memória para os parâmetros pRequestID e pServerAddress . O aplicativo deve usar SysFreeString para liberar a memória quando as variáveis não forem mais necessárias.

O TAPI chama o método AddRef na interface IMcastLeaseInfo retornada por IMcastAddressAllocation::CreateLeaseInfoFromVariant. O aplicativo deve chamar Release na interface IMcastLeaseInfo para liberar recursos associados a ele.

Essa função pode enviar dados sobre o fio em forma não criptografada; portanto, alguém escutando na rede pode ser capaz de ler os dados. O risco de segurança de enviar os dados em texto claro 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

IMcastLeaseInfo