Share via


SpCreateObjectFromSubToken (Windows CE 5.0)

Send Feedback

This function creates an object from a subkey of the data key belonging to an object token.

HRESULT SpCreateObjectFromSubToken(ISpObjectToken* pToken,constWCHAR* pszSubKeyName,T** ppObject,IUnknownpUnkOuter= NULL,DWORD* dwClsCtxt= CLSCTX_ALL);

Parameters

  • pToken
    [in] Pointer to an object implementing ISpObjectToken that contains the information associated with the object being created.
  • pszSubKeyName
    [in] Pointer to a null-terminated string specifying the name of the subkey of the data key corresponding to the token.
  • ppObject
    [out, iid_is(riid)] Address of a pointer to the interface indicated by riid, or NULL if the interface is not supported.
  • pUnkOuter
    [in] Optional pointer to IUnknown, used for creating aggregate objects. pUnkOuter is the data for the object. If not specified, the value defaults to NULL.
  • dwClsCtxt
    [in] Context in which the code that manages the newly created object will run. The following list shows the values. If a value is not specified, the parameter defaults to CLSCTX_ALL.
    • CLSCTX_ALL
    • CLSCTX_INPROC_SERVER
    • CLSCTX_INPROC_HANDLER
    • CLSCTX_LOCAL_SERVER
    • CLSCTX_REMOTE_SERVER

Return Values

The following table shows the possible return values.

Value Description
S_OK Function completed successfully.
FAILED(hr) Appropriate error message.

Requirements

OS Versions: Windows CE .NET 4.1 and later.
Header: Sphelper.h.
Link Library: Sapilib.lib.

See Also

SAPI Functions

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.