Méthode IMcastAddressAllocation::CreateLeaseInfoFromVariant (mdhcp.h)

Article
08/24/2023

[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 CreateLeaseInfoFromVariant crée un objet d’informations de bail pour un appel ultérieur à RenewAddress ou à ReleaseAddress. Cette méthode est similaire à CreateLeaseInfo , mais elle est utilisée par les langages clients Automation tels que Visual Basic.

Syntaxe

HRESULT CreateLeaseInfoFromVariant(
  [in]  DATE            LeaseStartTime,
  [in]  DATE            LeaseStopTime,
  [in]  VARIANT         vAddresses,
  [in]  BSTR            pRequestID,
  [in]  BSTR            pServerAddress,
  [out] IMcastLeaseInfo **ppReleaseRequest
);

Paramètres

[in] LeaseStartTime

Heure de début du bail.

[in] LeaseStopTime

Heure d’arrêt du bail.

[in] vAddresses

VARIANT contenant un SAFEARRAY de chaînes BSTR. Chaque BSTR est une adresse IP version 4 en notation quad en pointillés (par exemple, 10.111.222.111).

[in] pRequestID

Pointeur vers un BSTR spécifiant l’ID de la demande d’origine. Pour cela, appelez IMcastLeaseInfo::get_RequestID sur l’objet d’informations de bail correspondant à la demande d’origine. L’ID de demande doit être enregistré dans le stockage persistant entre les exécutions du programme d’application. Si vous renouvelez ou libérez un bail qui a été demandé pendant la même exécution de l’application, vous n’avez aucune raison d’utiliser CreateLeaseInfo ; passez simplement le pointeur IMcastLeaseInfo existant à RenewAddress ou ReleaseAddress.

[in] pServerAddress

Pointeur vers un BSTR spécifiant l’adresse du serveur.

[out] ppReleaseRequest

Pointeur vers l’interface IMcastLeaseInfo créée.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur	Signification
S_OK	La méthode a réussi.
E_POINTER	L’appelant a transmis un argument de pointeur non valide.
E_OUTOFMEMORY	Il n’existe pas suffisamment de mémoire pour créer les objets requis.

Notes

L’application doit utiliser SysAllocString pour allouer de la mémoire pour les paramètres pRequestID et pServerAddress . L’application doit utiliser SysFreeString pour libérer la mémoire lorsque les variables ne sont plus nécessaires.

TAPI appelle la méthode AddRef sur l’interface IMcastLeaseInfo retournée par IMcastAddressAllocation::CreateLeaseInfoFromVariant. L’application doit appeler Release sur l’interface IMcastLeaseInfo pour libérer les ressources qui lui sont associées.

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.

Spécifications


Plateforme cible	Windows
En-tête	mdhcp.h
Bibliothèque	Uuid.lib
DLL	Mdhcp.dll

Voir aussi

IMcastAddressAllocation

IMcastLeaseInfo

Partager via