ISpSREngineSite::SetRuleClientContext
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
This method sets an engine-defined pointer on a CFG rule. The method allows an engine to associate a pointer to its own data with each rule. The data can be quickly recovered with the ISpSREngineSite::GetRuleInfo method.
Syntax
HRESULT SetRuleClientContext(
SPRULEHANDLE hRule,
void* pvClientContext
);
Parameters
- hRule
[in] Handle to a CFG rule.
- pvClientContext
[in] Pointer to the engine data to associate with the rule.
Return Value
The following table shows the possible return values.
| Value | Description |
|---|---|
S_OK |
Function completed successfully. |
SPERR_INVALID_HANDLE |
Invalid rule handle argument. |
FAILED(hr) |
Other appropriate error message. |
Requirements
| Header | sapiddk.h, sapiddk.idl |
| Library | sapilib.lib |
| Windows Embedded CE | Windows CE .NET 4.1 and later |