ITRendezvous::CreateDirectory-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 CreateDirectory-Methode erstellt ein ITDirectory-Objekt, das einem Verzeichnis des angegebenen Typs und Namens entspricht.
Syntax
HRESULT CreateDirectory(
[in] DIRECTORY_TYPE DirectoryType,
[in] BSTR pName,
[out] ITDirectory **ppDir
);
Parameter
[in] DirectoryType
Der Typ des Verzeichnisses. Siehe DIRECTORY_TYPE.
[in] pName
Zeiger auf einen BSTR , der den Namen des zu erstellenden Verzeichnisses enthält.
[out] ppDir
Zeiger, um ein ITDirectory-Objekt des oben angegebenen Typs zu empfangen.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Wert | Bedeutung |
|---|---|
|
Methode war erfolgreich. |
|
Zum Ausführen des Vorgangs ist nicht genügend Arbeitsspeicher vorhanden. |
|
Der pName- oder ppDir-Parameter ist ein ungültiger Zeiger. |
|
Der DirectoryType-Parameter ist ungültig. |
Hinweise
Bei Verzeichnissen vom Typ DT_NTDS wird pName ignoriert, da Rendezvous nur die Verwendung des lokalen Domänencontrollers (DC) unterstützt.
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 auf der VON ITRendezvous::CreateDirectory zurückgegebenen ITDirectory-Schnittstelle auf. Die Anwendung muss Release auf der ITDirectory-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.
Requirements (Anforderungen)
| Zielplattform | Windows |
| Kopfzeile | rend.h |
| DLL | Rend.dll |