ITRendezvous ::CreateDirectoryObject, méthode (rend.h)
[Les contrôles et interfaces de conférence de téléphonie IP rendezvous 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 CreateDirectoryObject crée un objet ITDirectoryObject .
Syntaxe
HRESULT CreateDirectoryObject(
[in] DIRECTORY_OBJECT_TYPE DirectoryObjectType,
[in] BSTR pName,
[out] ITDirectoryObject **ppDirectoryObject
);
Paramètres
[in] DirectoryObjectType
Type de l'objet. Voir DIRECTORY_OBJECT_TYPE.
[in] pName
Pointeur vers un BSTR contenant le nom de l’objet.
[out] ppDirectoryObject
Pointeur pour recevoir le pointeur d’interface de l’objet ITDirectoryObject nouvellement créé.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Valeur | Signification |
|---|---|
|
La méthode a réussi. |
|
Le paramètre DirectoryObjectType n’est pas valide. |
|
La mémoire est insuffisante pour effectuer l’opération. |
|
Le pointeur n’est pas valide. |
Remarques
L’application doit utiliser SysAllocString pour allouer de la mémoire au paramètre pName et utiliser SysFreeString pour libérer la mémoire lorsque la variable n’est plus nécessaire.
TAPI appelle la méthode AddRef sur l’interface ITDirectoryObject retournée par ITRendezvous ::CreateDirectoryObject. L’application doit appeler Release sur l’interface ITDirectoryObject pour libérer les ressources qui lui sont associées.
Cette fonction peut envoyer des données sur le réseau sous forme non chiffrée ; par conséquent, une personne qui écoute sur 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 |