IDataModelScript::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. In diesem Fall sollte sie 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 über SysAllocString zugeordnete Zeichenfolge zurückgegeben werden. Der Aufrufer ist dafür verantwortlich, diese Zeichenfolge über die SysFreeString-Methode frei zu geben. Beachten Sie, dass, wenn das Skript unbenannt ist, die -Methode einen NULL-BSTR als Ausgabe zurückgeben sollte. Es sollte in diesem Fall weiterhin erfolgreich sein.
Rückgabewert
Diese Methode gibt HRESULT zurück, das den Erfolg oder Fehler angibt.
Anforderungen
Anforderung | Wert |
---|---|
Header | dbgmodel.h |