ITDirectory::EnumerateDirectoryObjects, méthode (rend.h)
[Les contrôles et interfaces de conférence de téléphonie IP rendez-vous 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 EnumerateDirectoryObjects crée une énumération d’objets d’annuaire d’un type et d’un nom donnés.
Syntaxe
HRESULT EnumerateDirectoryObjects(
[in] DIRECTORY_OBJECT_TYPE DirectoryObjectType,
[in] BSTR pName,
[out] IEnumDirectoryObject **ppEnumObject
);
Paramètres
[in] DirectoryObjectType
Critères DIRECTORY_OBJECT_TYPE pour l’objet souhaité.
[in] pName
Pointeur vers un BSTR contenant le nom complet ou partiel de l’objet. Le caractère générique « * » est pris en charge.
[out] ppEnumObject
Pointeur pour recevoir le pointeur d’interface IEnumDirectoryObject pour l’énumérateur des objets correspondants.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Valeur | Signification |
|---|---|
|
La méthode a réussi. |
|
La méthode ITDirectory::Connect n’a pas été appelée ou n’a pas réussi. |
|
Cette méthode n’est pas implémentée. |
Notes
L’application doit utiliser SysAllocString pour allouer de la mémoire pour le 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 IEnumDirectoryObject retournée par ITDirectory::EnumerateDirectoryObjectss. L’application doit appeler Release sur l’interface IEnumDirectoryObject pour libérer les ressources qui lui sont associées.
Configuration requise
| Plateforme cible | Windows |
| En-tête | rend.h |
| DLL | Rend.dll |