ISCardDatabase::GetProviderCardId

The GetProviderCardId method retrieves the identifier (GUID) of the primary service provider for the specified smart card.

HRESULT GetProviderCardId(
  BSTR bstrCardName,  
  LPGUID *ppguidProviderId
);

Parameters

bstrCardName
[in] Name of the smart card.
ppguidProviderId
[out, retval] Pointer to the primary service provider's identifier (GUID) if successful; NULL if operation failed.

Return Values

The possible return values are the following:

Value Meaning
S_OK Operation completed successfully.
E_INVALIDPARAMETER Invalid parameter.
E_POINTER A bad pointer was passed in ppguidProviderId.
E_OUTOFMEMORY Out of memory.

Remarks

To list the interfaces of the smart card, call ListCardInterfaces.

To retrieve all known smart cards, readers and reader groups call ListCard, ListReaders, and ListReaderGroups respectively.

For a list of all the methods provided by the ISCardDatabase interface, see ISCardDatabase.

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 on smart card error codes, see Error Codes.

QuickInfo

  Windows NT: Use version 4.0 SP3 and later.
  Windows: Use Windows 95 OSR2.1.
  Windows CE: Unsupported.
  Header: Declared in scardmgr.h.
  Import Library: scardmgr.tlb.

See Also

ISCardDatabase, ListCardInterfaces, ListCards, ListReaderGroups, ListReaders