IDataModelScript2::GetName-Methode (dbgmodel.h)
Die GetName-Methode gibt den Namen des Skripts als zugeordnete Zeichenfolge über die SysAllocString-Funktion zurück. Wenn das Skript noch keinen Namen hat, sollte die Methode einen NULL-BSTR zurückgeben. Es sollte in diesem Fall nicht scheitern. Wenn das Skript explizit über einen Aufruf der Rename-Methode umbenannt wird, sollte die GetName-Methode den neu zugewiesenen Namen zurückgeben.
Syntax
HRESULT GetName(
BSTR *scriptName
);
Parameter
scriptName
Der Name des Skripts sollte hier als Zeichenfolge zurückgegeben werden, die über SysAllocString zugewiesen wird. Der Aufrufer ist für das Freigeben dieser Zeichenfolge über die SysFreeString-Methode verantwortlich. Beachten Sie, dass die Methode, wenn das Skript nicht benannt ist, einen NULL-BSTR als Ausgabe zurückgeben soll. Es sollte in diesem Fall weiterhin erfolgreich sein.
Rückgabewert
Diese Methode gibt HRESULT zurück, das Erfolg oder Fehler angibt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | dbgmodel.h |