Share via


CardDeleteDirectory function

This function deletes a directory from the card. This operation fails if it violates permissions on the directory or if the directory is not empty.

Syntax

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

Parameters

  • pCardData [in]
    Context information for the call. For more information, see CardAcquireContext.

  • pszDirectoryName [in]
    Name of the directory.

Return value

Zero on success; otherwise, nonzero.

Remarks

Returns invalid argument error if NULL is passed as the directory name.

If CardDeleteDirectory is called without previous authentication, the call should return SCARD_W_SECURITY_VIOLATION.

If CardDeleteDirectory is called for a directory that is not empty (because it contains at least one file), ERROR_DIR_NOT_EMPTY should be returned.

If CardDeleteDirectory is called on a nonexistent directory, an SCARD_E_DIR_NOT_FOUND error code must be returned.

If the name that pszDirectoryName specified is longer than the maximum length that is defined for file/directory names, SCARD_E_INVALID_PARAMETER must be returned.

Requirements

Target platform

Desktop

Header

Cardmod.h (include Cardmod.h)

 

 

Send comments about this topic to Microsoft