P6API P6ERR P6CCALL P6R::p6CreateCryptoInstance | ( | const P6R::P6CID & | cid, |
const P6R::P6IID & | iid, | ||
P6VOID ** | ppIface | ||
) |
Creates a single uninitialized instance of the cryptographic interface associated with the specified component ID.
Crypto Components like all other P6R components, use two stage construction. Once a component interface is created using this method, you must call the interface's initialze() method to complete construction of the component.
This function must be used to create Cryptographic components which cannot be created using the standard p6CreateInstance() call.
cid | [ in ] The component ID of code to be used to create the instance. |
iid | [ in ] A reference to the interface ID that indicates the interface to be returned. |
ppIface | [ out ] The address of a variable that, on success, recieves the requested interface pointer, and on failure will be NULL. |
Success | P6R::eOk | An instance of the requested interface has been created. |
Failure | P6R::eNotInitialized | The [p6]COM runtime has no been initialized yet. You must call p6Initialize() before calling anything else. |
P6R::eNoInterface | The interface ID specified could not be found in the specified component. | |
P6R::eNotFound | The request component was not found. | |
P6R::eDllNotFound | The DLL resgistered for the requested component could not be loaded, or the COM runtime DLL could not be located. | |
P6R::eDllNotCom | The DLL resgistered for the requested component is not a COM component. | |
P6R::eAccessFault | ppIface is NULL. | |
P6R::eComponentNotFound | The request component is not found in the registered component DLL. | |
P6R::eNoMemory | The was not enough memory to create the requested component instance. |