Metodo ITDirectory::get_DirectoryObjects (rend.h)

Articolo
03/05/2024

[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 get_DirectoryObjects ottiene la raccolta di oggetti in una determinata directory che corrisponde a determinati criteri. Questo metodo esegue la stessa funzione di EnumerateDirectoryObjects , ma viene usata da Visual Basic e da altri linguaggi di scripting.

Sintassi

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

Parametri

[in] DirectoryObjectType

Criteri di DIRECTORY_OBJECT_TYPE per l'oggetto desiderato.

[in] pName

Puntatore a un BSTR contenente il nome completo o parziale dell'oggetto. Il carattere jolly "*" è supportato.

[out] pVariant

Puntatore a un valore VARIANT che riceve un ITCollection di oggetti ITDirectoryObject nel server che corrispondono alla descrizione.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Significato
S_OK	Il metodo è riuscito.
RND_NOT_CONNECTED	Il metodo ITDirectory::Connect non è stato richiamato o non è riuscito.
E_NOTIMPL	Questo metodo non è implementato.

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 ITDirectory::get_DirectoryObjects. L'applicazione deve chiamare Release nell'interfaccia ITDirectoryObject per liberare risorse associate.