Méthode IMcastLeaseInfo::get_RequestID (mdhcp.h)
[Les contrôles et interfaces de conférence de téléphonie IP rendez-vous ne sont pas disponibles pour une utilisation dans Windows Vista, Windows Server 2008 et les versions ultérieures du système d’exploitation. L’API cliente RTC fournit des fonctionnalités similaires.]
La méthode get_RequestID obtient l’ID de demande pour un bail. L’objectif principal de cette méthode est de vous permettre d’enregistrer l’ID de demande après la sortie de votre application, afin que vous puissiez appeler IMcastAddressAllocation::CreateLeaseInfo pour recréer l’objet d’informations de bail lors d’une exécution ultérieure. Cela vous permet de renouveler ou de libérer un bail après la fin de la instance de votre programme qui demandait initialement le bail.
Syntaxe
HRESULT get_RequestID(
[out] BSTR *ppRequestID
);
Paramètres
[out] ppRequestID
Pointeur vers un BSTR qui recevra l’ID de demande pour ce bail. L’ID de demande identifie de manière unique cette demande de bail au serveur.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code de retour | Description |
|---|---|
|
La méthode a réussi. |
|
L’objet d’informations de bail contient un ID de demande non valide. |
|
L’appelant a transmis un argument de pointeur non valide. |
|
Mémoire insuffisante pour allouer le BSTR. |
Notes
L’application doit utiliser SysFreeString pour libérer la mémoire allouée pour le paramètre ppRequestID .
Cette fonction peut envoyer des données sur le câble sous forme non chiffrée ; par conséquent, une personne qui écoute le réseau peut être en mesure de lire les données. Le risque de sécurité lié à l’envoi des données en texte clair doit être pris en compte avant d’utiliser cette méthode.
Configuration requise
| Plateforme cible | Windows |
| En-tête | mdhcp.h |
| Bibliothèque | Uuid.lib |
| DLL | Mdhcp.dll |