Método IMcastLeaseInfo::get_RequestID (mdhcp.h)
[Los controles e interfaces de conferencia de telefonía IP de encuentro no están disponibles para su uso en Windows Vista, Windows Server 2008 y versiones posteriores del sistema operativo. La API de cliente RTC proporciona una funcionalidad similar.]
El método get_RequestID obtiene el identificador de solicitud de una concesión. El propósito principal de este método es permitir guardar el identificador de solicitud después de que se cierre la aplicación, de modo que pueda llamar a IMcastAddressAllocation::CreateLeaseInfo para volver a crear el objeto de información de concesión durante una ejecución posterior. Esto le permite renovar o liberar una concesión después de que se haya cerrado la instancia del programa que solicitó originalmente la concesión.
Sintaxis
HRESULT get_RequestID(
[out] BSTR *ppRequestID
);
Parámetros
[out] ppRequestID
Puntero a un BSTR que recibirá el identificador de solicitud para esta concesión. El identificador de solicitud identifica de forma única esta solicitud de concesión al servidor.
Valor devuelto
Este método puede devolver uno de estos valores.
| Código devuelto | Descripción |
|---|---|
|
El método se realizó correctamente. |
|
El objeto de información de concesión contiene un identificador de solicitud no válido. |
|
El llamador pasó en un argumento de puntero no válido. |
|
Memoria insuficiente para asignar el BSTR. |
Comentarios
La aplicación debe usar SysFreeString para liberar la memoria asignada para el parámetro ppRequestID .
Esta función puede enviar datos a través de la conexión en forma sin cifrar; por lo tanto, es posible que alguien intercepte en la red pueda leer los datos. El riesgo de seguridad de enviar los datos en texto no cifrado debe tenerse en cuenta antes de usar este método.
Requisitos
| Plataforma de destino | Windows |
| Encabezado | mdhcp.h |
| Library | Uuid.lib |
| Archivo DLL | Mdhcp.dll |