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

Article
08/24/2023

[Les contrôles et interfaces de conférence de téléphonie IP rendezvous 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 CreateLeaseInfo crée un objet d’informations de bail pour un appel ultérieur à RenewAddress ou ReleaseAddress.

Syntaxe

HRESULT CreateLeaseInfo(
  [in]  DATE            LeaseStartTime,
  [in]  DATE            LeaseStopTime,
  [in]  DWORD           dwNumAddresses,
  [in]  LPWSTR          *ppAddresses,
  [in]  LPWSTR          pRequestID,
  [in]  LPWSTR          pServerAddress,
  [out] IMcastLeaseInfo **ppReleaseRequest
);

Paramètres

[in] LeaseStartTime

Heure de début du bail.

[in] LeaseStopTime

Heure d’arrêt du bail.

[in] dwNumAddresses

Nombre d’adresses associées au bail.

[in] ppAddresses

Tableau de pointeurs LPWSTR de taille dwNumAddresses. Chaque LPWSTR est une adresse IP version 4 en quatre points (par exemple, 10.111.222.111).

[in] pRequestID

LPWSTR 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 un 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 ; il suffit de passer le pointeur IMcastLeaseInfo existant vers RenewAddress ou ReleaseAddress.

[in] pServerAddress

Spécifie 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 passé un argument pointeur non valide.
E_OUTOFMEMORY	Mémoire insuffisante pour créer les objets requis.

Notes

TAPI appelle la méthode AddRef sur l’interface IMcastLeaseInfo retournée par IMcastAddressAllocation::CreateLeaseInfo. 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 réseau sous forme non chiffrée ; par conséquent, une personne qui écoute sur 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

Voir aussi

IMcastAddressAllocation

Partager via