IScriptNode::CreateChildHandler
Adds a scriptlet as a child instance of an IScriptNode
.
Syntax
HRESULT CreateChildHandler(
LPCOLESTR pszDefaultName,
LPCOLESTR *prgpszNames,
ULONG cpszNames,
LPCOLESTR pszEvent,
LPCOLESTR pszDelimiter,
ITypeInfo* ptiSignature,
ULONG iMethodSignature,
ULONG isn,
DWORD dwCookie,
IScriptEntry **ppse
);
Parameters
pszDefaultName
[in] The address of the default name to associate with the scriptlet.
prgpszNames
[in, size_is(cpszNames
)] A list of identifiers from the fully qualified name on the host.
cpszNames
[in] The number of identifiers in the prgpszNames
parameter.
pszEvent
[in] The buffer address that identifies the event name associated with the scriptlet.
pszDelimiter
[in] The address of the end-of-script-block delimiter. For parsing, the host typically uses a delimiter (such as two single quotation marks), to detect the end of the script block.
The delimiter enables preprocessing by the script authoring engine. For example, the engine might replace a single quotation mark with two single quotation marks for use as a delimiter. The engine determines how the delimiter is used.
Set to NULL if no delimiter is used to identify the end of the script block.
ptiSignature
[in] The type information for a function object.
iMethodSignature
[in] The index of the function in the ITypeInfo``ptiSignature
parameter.
isn
[in] The index of the child in the parent.
dwCookie
[in] An application-defined value that is used to associate the entry with the host object.
ppse
[out] The address of a variable that receives a pointer to the IScriptEntry
interface of the child instance.
Return Value
An HRESULT
. Possible values include, but are not limited to, those in the following table.
Value | Description |
---|---|
S_OK |
The method succeeded. |
Remarks
A scriptlet specifies an event handler. This method creates a scriptlet if it is called by an IScriptNode
object that represents a Web page. This method does not succeed if it is called by other interfaces.