IConsole3::RenameScopeItem-Methode (mmc.h)
Die RenameScopeItem-Methode versetzt das angegebene Bereichselement programmgesteuert in den Umbenennungsmodus. Anschließend kann der Benutzer den neuen Namen manuell eingeben.
Verwenden Sie diese Methode nur, wenn ein Element erstellt wird und sofort in den Umbenennungsmodus versetzt werden muss. Die Verwendung dieser Methode für andere Szenarien, z. B. das Aufrufen, nachdem ein Element ausgewählt wurde, wird nicht unterstützt und kann zu unerwarteten Ergebnissen führen.
Syntax
HRESULT RenameScopeItem(
[in] HSCOPEITEM hScopeItem
);
Parameter
[in] hScopeItem
Das Bereichselement, das in den Umbenennungsmodus versetzt wird.
Rückgabewert
Bei erfolgreicher Ausführung wird der Rückgabewert S_OK. Wenn der Fehler nicht erfolgreich ist, gibt die Methode E_FAIL zurück.
Hinweise
Damit diese Methode erfolgreich ist, muss für das Element, das in den Umbenennungsmodus versetzt wird, das Verb Umbenennen aktiviert sein, und der Bereichsbereich darf nicht unsichtbar sein.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | mmc.h |
| Bibliothek | Mmc.lib |
| DLL | Mmcndmgr.dll |