ITRendezvous::CreateDirectory, 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 CreateDirectory crée un objet ITDirectory correspondant à un répertoire du type et du nom donnés.
Syntaxe
HRESULT CreateDirectory(
[in] DIRECTORY_TYPE DirectoryType,
[in] BSTR pName,
[out] ITDirectory **ppDir
);
Paramètres
[in] DirectoryType
Type du répertoire. Voir DIRECTORY_TYPE.
[in] pName
Pointeur vers un BSTR contenant le nom du répertoire à créer.
[out] ppDir
Pointeur pour recevoir un objet ITDirectory du type spécifié ci-dessus.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Valeur | Signification |
|---|---|
|
La méthode a réussi. |
|
La mémoire est insuffisante pour effectuer l’opération. |
|
Le paramètre pName ou ppDir est un pointeur non valide. |
|
Le paramètre DirectoryType n’est pas valide. |
Notes
Pour les répertoires de type DT_NTDS, pName est ignoré, car Rendezvous prend en charge l’utilisation du contrôleur de domaine local uniquement.
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 ITDirectory retournée par ITRendezvous::CreateDirectory. L’application doit appeler Release sur l’interface ITDirectory 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
| Plateforme cible | Windows |
| En-tête | rend.h |
| DLL | Rend.dll |