Método ITDirectoryObjectUser::p ut_IPPhonePrimary (rend.h)
[Controles e interfaces de conferência de telefonia ip de encontro não estão disponíveis para uso no Windows Vista, Windows Server 2008 e versões subsequentes do sistema operacional. A API do Cliente RTC fornece funcionalidade semelhante.]
O método put_IPPhonePrimary define o nome de um computador como o telefone IP primário para um usuário.
Sintaxe
HRESULT put_IPPhonePrimary(
[in] BSTR pName
);
Parâmetros
[in] pName
Ponteiro para a representação BSTR do telefone ip primário do usuário.
Retornar valor
Esse método pode retornar um desses valores.
| Código de retorno | Descrição |
|---|---|
|
O método foi bem-sucedido. |
|
Ponteiro inválido. |
Comentários
Esse método só pode ser usado em um novo objeto que é adicionado posteriormente ao diretório. Se um aplicativo quiser modificar o telefone IP de um objeto de usuário existente, ele precisará enumerar os objetos do servidor para determinar se os telefones IP antigos são. Isso implica que um aplicativo TAPI 3 está em execução em um ou mais computadores. O aplicativo em um computador local não tem informações sobre se esses outros aplicativos ainda estão em execução. Portanto, não é o lugar do aplicativo alterar o TELEFONE IP em objetos de usuário existentes.
Para modificar o telefone IP de um usuário existente, o usuário deve ser excluído e adicionado novamente.
O aplicativo deve usar SysAllocString para alocar memória para o parâmetro pName e usar SysFreeString para liberar a memória quando a variável não for mais necessária.
Essa função pode enviar dados sobre o fio em forma não criptografada; portanto, alguém escutando na rede pode ser capaz de ler os dados. O risco de segurança de enviar os dados em texto claro deve ser considerado antes de usar esse método.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | rend.h |
| DLL | Rend.dll |