Share via


CardDeauthenticate Function

The CardDeauthenticate function, defined by a smart card module, reverses the effect of authenticating a user or administrator without resetting the smart card.

Syntax

DWORD WINAPI CardDeauthenticate(
  __in  PCARD_DATA pCardData,
  __in  LPWSTR pwszUserId,
  __in  DWORD dwFlags
);

Parameters

  • pCardData [in]
    A pointer to a CARD_DATA structure received from a call to the CardAcquireContext function.

  • pwszUserId [in]
    A pointer to a null-terminated wide character string that contains the user ID for whom authentication is to be removed.

  • dwFlags [in]
    Reserved. This parameter must be set to zero.

Return Value

If the function succeeds, it returns zero.

If the function fails, it returns a nonzero value, and the Microsoft Base Smart Card Cryptographic Service Provider (CSP) or smart card key storage provider (KSP) resets the smart card.

Requirements

Minimum supported client Windows XP, Windows 2000 Professional with SP4
Minimum supported server Windows Server 2003, Windows 2000 Server with SP4
Header Cardmod.h

See Also

Microsoft Base Smart Card Cryptographic Service Provider

CARD_DATA

CardAcquireContext

Send comments about this topic to Microsoft

Build date: 3/5/2009