ITRendezvous::CreateDirectoryObject-Methode (rend.h)
[Rendezvous IP-Telefonkonferenzsteuerelemente und -schnittstellen sind in Windows Vista, Windows Server 2008 und nachfolgenden Versionen des Betriebssystems nicht verfügbar. Die RTC-Client-API bietet ähnliche Funktionen.]
Die CreateDirectoryObject-Methode erstellt ein neues ITDirectoryObject-Objekt .
Syntax
HRESULT CreateDirectoryObject(
[in] DIRECTORY_OBJECT_TYPE DirectoryObjectType,
[in] BSTR pName,
[out] ITDirectoryObject **ppDirectoryObject
);
Parameter
[in] DirectoryObjectType
Der Typ des Objekts. Siehe DIRECTORY_OBJECT_TYPE.
[in] pName
Zeiger auf einen BSTR , der den Namen des Objekts enthält.
[out] ppDirectoryObject
Zeiger, um den Schnittstellenzeiger für das neu erstellte ITDirectoryObject-Objekt zu empfangen.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Wert | Bedeutung |
|---|---|
|
Methode war erfolgreich. |
|
Der DirectoryObjectType-Parameter ist ungültig. |
|
Zum Ausführen des Vorgangs ist nicht genügend Arbeitsspeicher vorhanden. |
|
Der Zeiger ist ungültig. |
Hinweise
Die Anwendung muss SysAllocString verwenden, um Arbeitsspeicher für den pName-Parameter zuzuweisen und SysFreeString zum Freigeben des Arbeitsspeichers verwenden, wenn die Variable nicht mehr benötigt wird.
TAPI ruft die AddRef-Methode für die von ITRendezvous::CreateDirectoryObject zurückgegebene ITDirectoryObject-Schnittstelle auf. Die Anwendung muss Release auf der ITDirectoryObject-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.
Diese Funktion kann Daten unverschlüsselt über die Leitung senden. Daher kann jemand, der im Netzwerk lauscht, die Daten lesen. Das Sicherheitsrisiko des Sendens der Daten im Klartext sollte vor der Verwendung dieser Methode berücksichtigt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | rend.h |
| DLL | Rend.dll |