SCardEstablishContext

This function establishes the resource manager context (the scope) within which database operations are performed.

LONG SCardEstablishContext(
IN DWORD dwScope, 
IN LPCVOID pvReserved1, 
IN LPCVOID pvReserved2, 
OUT LPSCARDCONTEXT phContext );

Parameters

• dwScope
  Specifies the scope of the resource manager context. The following list shows the possible values for dwScope.

  Value	Description
  SCARD_SCOPE_SYSTEM	Database operations are performed within the domain of the system. The calling application must have appropriate access permissions for any database actions.
  SCARD_SCOPE_USER	Unsupported. If specified, Windows CE assumes the SCARD_SCOPE_SYSTEM value.

• pvReserved1
  Void pointer reserved for future use; must be NULL. Reserved to enable a suitably privileged management application to act on behalf of another user.

• pvReserved2
  Void pointer reserved for future use; must be NULL. Reserved to enable a suitably privileged management application to act on behalf of another terminal.

• phContext
  Pointer to a handle to the established resource manager context. This handle can now be supplied to other functions attempting to do work within this context.

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

The context handle returned by SCardEstablishContext can be used by database query and management functions.

To release an established resource manager context, see SCardReleaseContext.

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

SCardReleaseContext

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.