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
S_OK	El método se realizó correctamente.
S_FAIL	El objeto de información de concesión contiene un identificador de solicitud no válido.
E_POINTER	El llamador pasó en un argumento de puntero no válido.
E_OUTOFMEMORY	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

Consulte también

IMcastLeaseInfo