Método IMcastAddressAllocation::CreateLeaseInfoFromVariant (mdhcp.h)
[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 |
|---|---|
|
O método foi bem-sucedido. |
|
O chamador passou em um argumento de ponteiro inválido. |
|
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 |