Método IMcastLeaseInfo::get_RequestID (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 get_RequestID obtém a ID de solicitação de uma concessão. A principal finalidade desse método é permitir que você salve a ID da solicitação após a saída do aplicativo, para que você possa chamar IMcastAddressAllocation::CreateLeaseInfo para recriar o objeto de informações de concessão durante uma execução subsequente. Isso permite que você renove ou libere uma concessão após a saída da instância do programa que solicitou originalmente a concessão.
Sintaxe
HRESULT get_RequestID(
[out] BSTR *ppRequestID
);
Parâmetros
[out] ppRequestID
Ponteiro para um BSTR que receberá a ID de solicitação para essa concessão. A ID da solicitação identifica exclusivamente essa solicitação de concessão para o servidor.
Valor retornado
Esse método pode retornar um desses valores.
| Código de retorno | Descrição |
|---|---|
|
O método foi bem-sucedido. |
|
O objeto de informações de concessão contém uma ID de solicitação inválida. |
|
O chamador passou em um argumento de ponteiro inválido. |
|
Memória insuficiente para alocar o BSTR. |
Comentários
O aplicativo deve usar SysFreeString para liberar a memória alocada para o parâmetro ppRequestID .
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 |