CardDeauthenticate function

This topic is not current. For the most current information about the Smart Card API, see Smart Card Minidriver Specification.

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 [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Header
Cardmod.h

See also

Microsoft Base Smart Card Cryptographic Service Provider

CARD_DATA

CardAcquireContext