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

See also

Microsoft Base Smart Card Cryptographic Service Provider

CARD_DATA

CardAcquireContext