Edit

Share via

ISCardManage::CreateInterface method

  • Article

[The CreateInterface method is available for use in the operating systems specified in the Requirements section. The Smart Card Modules provide similar functionality.]

The CreateInterface method creates the specified interface.

Syntax

HRESULT CreateInterface(
  [in]  LPGUID    pguidInterface,
  [in]  BSTR      bstrName,
  [in]  LONG      *pUserData,
  [out] LPUNKNOWN *ppInterface
);

Parameters

pguidInterface [in]

The GUID value of the interface to create.

bstrName [in]

The name of the interface to create if the GUID is unavailable. Standard values are "CryptoProvider".

pUserData [in]

Pointer to user-specific data to use in the creation of an interface.

ppInterface [out]

Pointer to the returned interface.

Return value

The possible return values are the following:

Return code Description
S_OK
 Operation completed successfully.
E_INVALIDARG
 One of the supplied parameters are not valid.
E_POINTER
 A bad pointer was passed in either the pguidInterface or the pUserData parameter.
E_OUTOFMEMORY
 Out of memory.

 

Remarks

For a list of all the methods defined by the ISCardManage interface, see ISCardManage.

In addition to the COM error codes listed above, this interface may return a smart card error code if a smart card function was called to complete the request. For information about smart card error codes, see Smart Card Return Values.

Requirements

Requirement Value
Minimum supported client
 Windows XP [desktop apps only]
Minimum supported server
 Windows Server 2003 [desktop apps only]
End of client support
 Windows XP
End of server support
 Windows Server 2003

See also

ISCardManage