ITDirectoryObjectUser::p ut_IPPhonePrimary-Methode (rend.h)
[Steuerelemente und Schnittstellen für Rendezvous-IP-Telefonkonferenzen sind in Windows Vista, Windows Server 2008 und nachfolgenden Versionen des Betriebssystems nicht verfügbar. Die RTC-Client-API bietet ähnliche Funktionen.]
Die put_IPPhonePrimary-Methode legt den Namen eines Computers als primäres IP-Telefon für einen Benutzer fest.
Syntax
HRESULT put_IPPhonePrimary(
[in] BSTR pName
);
Parameter
[in] pName
Zeiger auf die BSTR-Darstellung des primären IP-Telefons des Benutzers.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Methode war erfolgreich. |
|
Der Zeiger ist ungültig. |
Bemerkungen
Diese Methode kann nur für ein neues Objekt verwendet werden, das anschließend dem Verzeichnis hinzugefügt wird. Wenn eine Anwendung das IP-Telefon eines vorhandenen Benutzerobjekts ändern möchte, muss sie die Objekte vom Server auflisten, um die alten IP-Telefone zu bestimmen. Dies impliziert, dass eine TAPI 3-Anwendung auf einem oder mehreren anderen Computern ausgeführt wird. Die Anwendung auf einem lokalen Computer enthält keine Informationen darüber, ob diese anderen Anwendungen noch ausgeführt werden. Daher ist es nicht der Ort der Anwendung, das IP-Telefon für vorhandene Benutzerobjekte zu ändern.
Um das IP-Telefon eines vorhandenen Benutzers zu ändern, muss der Benutzer gelöscht und erneut hinzugefügt werden.
Die Anwendung muss SysAllocString verwenden, um Arbeitsspeicher für den pName-Parameter zuzuweisen, und SysFreeString muss den Arbeitsspeicher freigeben, wenn die Variable nicht mehr benötigt wird.
Diese Funktion kann Daten unverschlüsselt über das Kabel senden; Daher kann jemand, der im Netzwerk lauscht, die Daten lesen. Das Sicherheitsrisiko beim Senden der Daten im Klartext sollte vor der Verwendung dieser Methode berücksichtigt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | rend.h |
| DLL | Rend.dll |