Metodo ITDirectoryObjectUser::p ut_IPPhonePrimary (rend.h)
[I controlli e le interfacce di telefonia IP rendezvous IP non sono disponibili per l'uso in Windows Vista, Windows Server 2008 e versioni successive del sistema operativo. L'API client RTC offre funzionalità simili.
Il metodo put_IPPhonePrimary imposta il nome di un computer come telefono IP primario per un utente.
Sintassi
HRESULT put_IPPhonePrimary(
[in] BSTR pName
);
Parametri
[in] pName
Puntatore alla rappresentazione BSTR del telefono primario IP dell'utente.
Valore restituito
Questo metodo può restituire uno di questi valori.
| Codice restituito | Descrizione |
|---|---|
|
Il metodo è riuscito. |
|
Puntatore non valido. |
Commenti
Questo metodo può essere utilizzato solo in un nuovo oggetto che viene successivamente aggiunto alla directory. Se un'applicazione vuole modificare il telefono IP di un oggetto utente esistente, è necessario enumerare gli oggetti dal server per determinare i vecchi telefoni IP. Ciò implica che un'applicazione TAPI 3 è in esecuzione in uno o più computer. L'applicazione in un computer locale non contiene informazioni sul fatto che tali altre applicazioni siano ancora in esecuzione. Pertanto, non è la posizione dell'applicazione per modificare il telefono IP sugli oggetti utente esistenti.
Per modificare il telefono IP di un utente esistente, l'utente deve essere eliminato e aggiunto nuovamente.
L'applicazione deve usare SysAllocString per allocare memoria per il parametro pName e usare SysFreeString per liberare la memoria quando la variabile non è più necessaria.
Questa funzione può inviare dati in transito in formato non crittografato; pertanto, un utente che esegue l'intercettazione sulla rete potrebbe essere in grado di leggere i dati. Il rischio di sicurezza di inviare i dati in testo non crittografato deve essere considerato prima di usare questo metodo.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | rend.h |
| DLL | Rend.dll |