Metodo ITRendezvous::CreateDirectoryObject (rend.h)
[I controlli e le interfacce di telefonia IP rendezvous 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 CreateDirectoryObject crea un nuovo oggetto ITDirectoryObject .
Sintassi
HRESULT CreateDirectoryObject(
[in] DIRECTORY_OBJECT_TYPE DirectoryObjectType,
[in] BSTR pName,
[out] ITDirectoryObject **ppDirectoryObject
);
Parametri
[in] DirectoryObjectType
Tipo dell'oggetto. Vedere DIRECTORY_OBJECT_TYPE.
[in] pName
Puntatore a un BSTR contenente il nome dell'oggetto.
[out] ppDirectoryObject
Puntatore per ricevere il puntatore dell'interfaccia per l'oggetto ITDirectoryObject appena creato.
Valore restituito
Questo metodo può restituire uno di questi valori.
| Valore | Significato |
|---|---|
|
Il metodo è riuscito. |
|
Il parametro DirectoryObjectType non è valido. |
|
Memoria insufficiente per eseguire l'operazione. |
|
Puntatore non è valido. |
Commenti
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.
TAPI chiama il metodo AddRef nell'interfaccia ITDirectoryObject restituita da ITRendezvous::CreateDirectoryObject. L'applicazione deve chiamare Release nell'interfaccia ITDirectoryObject per liberare risorse associate.
Questa funzione può inviare dati attraverso il cavo in formato non crittografato; pertanto, un utente che esegue l'intercettazione sulla rete può essere in grado di leggere i dati. Il rischio di sicurezza di inviare i dati in testo chiaro deve essere considerato prima di usare questo metodo.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | rend.h |
| DLL | Rend.dll |