CardDeleteDirectory function

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

The CardDeleteDirectory function, defined by a smart card module, deletes a directory from a smart card. The directory must be empty, and the caller must have permission to delete that directory.

Syntax

DWORD WINAPI CardDeleteDirectory(
  _In_ PCARD_DATA pCardData,
  _In_ LPSTR      pszDirectoryName
);

Parameters

pCardData [in]

A pointer to a CARD_DATA structure received from a call to the CardAcquireContext function.

pszDirectoryName [in]

A pointer to a null-terminated string that contains the name of the directory to delete.

Return value

If the function succeeds, the function returns zero.

If the function fails, it returns a nonzero error value or one of the following possible error values.

Return code/value Description
SCARD_W_SECURITY_VIOLATION
2148532330 (0x8010006A)
The caller did not authenticate to the smart card before calling this function.

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

CardCreateDirectory