SCardGetProviderId
This function returns the globally unique identifier (GUID) of the primary service provider for a specified card.
The caller supplies the name of a smart card, previously introduced to the system, and receives the registered identifier of the primary service provider GUID, if one exists.
LONG SCardGetProviderId(
IN SCARDCONTEXT hContext,
IN LPCTSTR szCard,
OUT LPGUID pguidProviderId );
Parameters
- hContext
Handle that identifies the resource manager context for the query. The resource manager context can be set by a previous call to SCardEstablishContext or set to NULL if the query is not directed towards a specific context. - szCard
Null-terminated string that contains the name of the card defined to the system. - pguidProviderId
Pointer to a globally unique identifier (GUID) of the primary service provider. This provider can be activated by means of COM and supplies access to other services in the card.
Return Values
| Value | Description |
|---|---|
| Succeeds | SCARD_S_SUCCESS |
| Fails | An error value (see Smart Card Error values for a list of all error values) |
Remarks
SCardGetProviderId is a database query function.
Requirements
| Runs on | Versions | Defined in | Include | Link to |
|---|---|---|---|---|
| Windows CE OS | 3.0 and later | Winscard.h | Winscard.lib |
Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also
SCardEstablishContext, SCardListCards, SCardListInterfaces, SCardListReaders
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.