ITDirectoryObjectUser ::p ut_IPPhonePrimary, méthode (rend.h)

  • Article

[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 put_IPPhonePrimary définit le nom d’une machine en tant que téléphone IP principal pour un utilisateur.

Syntaxe

HRESULT put_IPPhonePrimary(
  [in] BSTR pName
);

Paramètres

[in] pName

Pointeur vers la représentation BSTR du téléphone IP principal de l’utilisateur.

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.
E_POINTER
 Pointeur non valide.

Remarques

Cette méthode ne peut être utilisée que sur un nouvel objet qui est ensuite ajouté au répertoire. Si une application souhaite modifier le téléphone IP d’un objet utilisateur existant, elle doit énumérer les objets du serveur pour déterminer les anciens téléphones IP. Cela implique qu’une application TAPI 3 s’exécute sur une ou plusieurs autres machines. L’application sur un ordinateur local ne dispose d’aucune information indiquant si ces autres applications sont toujours en cours d’exécution. Par conséquent, il n’est pas l’emplacement de l’application pour modifier le téléphone IP sur les objets utilisateur existants.

Pour modifier le téléphone IP d’un utilisateur existant, l’utilisateur doit être supprimé et ajouté à nouveau.

L’application doit utiliser SysAllocString pour allouer de la mémoire pour le paramètre pName et utiliser SysFreeString pour libérer la mémoire lorsque la variable n’est plus nécessaire.

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 rend.h
DLL Rend.dll

Voir aussi

ITDirectoryObjectUser

ITDirectoryObjectUser ::get_IPPhonePrimary