ITDirectoryObject::p ut_Name-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 put_Name-Methode legt den Namen des Verzeichnisobjekts fest.
Syntax
HRESULT put_Name(
[in] BSTR pName
);
Parameter
[in] pName
Zeiger auf die BSTR-Darstellung des Verzeichnisnamens.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Methode war erfolgreich. |
|
Der pName-Parameter ist kein gültiger Zeiger. |
|
Zum Ausführen des Vorgangs ist nicht genügend Arbeitsspeicher vorhanden. |
|
Unbekannter Fehler. |
|
Diese Methode ist noch nicht implementiert. |
Hinweise
Vorgenommene Änderungen werden erst auf dem Server wirksam, wenn die METHODE ITDirectory::ModifyDirectoryObject aufgerufen wird.
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.
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 |