Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This function creates an object from tokens that best match a set of attributes.
HRESULT SpCreateBestObject(constWCHAR* pszCategoryId,constWCHAR* pszReqAttribs,constWCHAR* pszOptAttribs,T** ppObject,IUnknown* pUnkOuter=NULL,DWORDdwClsCtxt=CLSCTX_ALL,);
Parameters
- pszCategoryId
[in] Pointer to the category identifier on which to base the new token. - pszReqAttribs
[in] Pointer to required attributes for the token. - pszOptAttribs
[in] Pointer to optional attributes for 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 possible 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
Send Feedback on this topic to the authors