Méthode IMcastAddressAllocation::RequestAddress (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 RequestAddress obtient un nouveau bail pour une ou plusieurs adresses de multidiffusion. La méthode EnumerateScopes ou get_Scopes doit être appelée en premier.

Syntaxe

HRESULT RequestAddress(
  [in]  IMcastScope     *pScope,
  [in]  DATE            LeaseStartTime,
  [in]  DATE            LeaseStopTime,
  [in]  long            NumAddresses,
  [out] IMcastLeaseInfo **ppLeaseResponse
);

Paramètres

[in] pScope

Identifie l’étendue de multidiffusion à partir de laquelle l’application a besoin d’une adresse. L’application appelle d’abord get_Scopes ou EnumerateScopes pour obtenir une liste d’étendues disponibles.

[in] LeaseStartTime

Heure demandée pour le début du bail sur ces adresses. L’heure de début effectivement accordée peut être différente.

[in] LeaseStopTime

Délai demandé pour que le bail sur ces adresses s’arrête. Le temps d’arrêt accordé peut être différent.

[in] NumAddresses

Nombre d’adresses demandées. Moins d’adresses peuvent en fait être accordées.

[out] ppLeaseResponse

Pointeur vers un pointeur d’interface qui sera défini pour pointer vers un nouvel objet IMcastLeaseInfo . Cette interface peut ensuite être utilisée pour découvrir les attributs réels du bail accordé. Pour plus d’informations, consultez IMcastScope .

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.
E_INVALIDARG	L’heure d’arrêt demandée est antérieure à l’heure d’arrêt demandée.

Notes

Bien que ces interfaces COM et leur implémentation prennent en charge l’allocation de plusieurs adresses à la fois, l’allocation multiple n’est actuellement pas prise en charge par les appels de fonction sous-jacents. Vous devrez peut-être utiliser une boucle pour l’allocation de plusieurs adresses.

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

Spécifications


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

Voir aussi

IMcastAddressAllocation

Partager via