Partager via


Méthode IMcastLeaseInfo ::get_ServerAddress (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_ServerAddress obtient une chaîne représentant l’adresse du serveur de multidiffusion qui accorde ce bail.

Syntaxe

HRESULT get_ServerAddress(
  [out] BSTR *ppAddress
);

Paramètres

[out] ppAddress

Pointeur vers un BSTR qui recevra une représentation sous forme de chaîne de l’adresse du serveur qui accorde cette demande ou ce renouvellement.

Valeur retournée

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

Code de retour Description
S_OK
La méthode a réussi.
S_FALSE
Adresse du serveur non spécifiée.
E_POINTER
L’appelant a transmis un argument de pointeur non valide.
E_OUTOFMEMORY
Il n’existe pas assez de mémoire pour allouer la chaîne.

Remarques

La chaîne BSTRppAddress est une adresse IP version 4 en notation quad en pointillés (par exemple, 10.111.222.111). Si un objet d’informations de bail ne décrit pas un bail accordé (par exemple, il n’a pas été retourné par IMcastAddressAllocation ::RequestAddress ou IMcastAddressAllocation ::RenewAddress), l’adresse est signalée sous la forme de la chaîne « Unspecified ».

L’application doit utiliser SysFreeString pour libérer la mémoire allouée pour le paramètre ppAddress .

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

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

Voir aussi

IMcastLeaseInfo