ITDirectory ::get_DirectoryObjects, méthode (rend.h)

Article
03/01/2024

[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 get_DirectoryObjects obtient la collection d’objets dans un répertoire donné qui correspond à certains critères. Cette méthode exécute la même fonction que EnumerateDirectoryObjects, mais est utilisée par Visual Basic et d’autres langages de script.

Syntaxe

HRESULT get_DirectoryObjects(
  [in]  DIRECTORY_OBJECT_TYPE DirectoryObjectType,
  [in]  BSTR                  pName,
  [out] VARIANT               *pVariant
);

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] pVariant

Pointeur vers un VARIANT qui reçoit une ITCollection d’objets ITDirectoryObject dans le serveur qui correspondent à la description.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur	Signification
S_OK	La méthode a réussi.
RND_NOT_CONNECTED	La méthode ITDirectory ::Connect n’a pas été appelée ou n’a pas réussi.
E_NOTIMPL	Cette méthode n’est pas implémentée.

Remarques

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 ITDirectoryObject retournée par ITDirectory ::get_DirectoryObjects. L’application doit appeler Release sur l’interface ITDirectoryObject pour libérer les ressources qui lui sont associées.