CardGetFileInfo Function

  • Article

The CardGetFileInfo function, defined by a smart card module, gets the size and access permissions of a smart card file.

Syntax

DWORD WINAPI CardGetFileInfo(
  __in     PCARD_DATA pCardData,
  __in     LPSTR pszDirectoryName,
  __in     LPSTR pszFileName,
  __inout  PCARD_FILE_INFO pCardFileInfo
);

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 that contains the file. The function fails if the specified directory does not exist. Set the value of this parameter to NULL if the file is in the ROOT directory.

  • pszFileName [in]
    A pointer to a null-terminated string that contains the name of the file. The function fails if the specified file does not exist.

  • pCardFileInfo [in, out]
    On input, this parameter contains a pointer to a CARD_FILE_INFO structure.

    On output, the CARD_FILE_INFO structure contains the size and access permissions of the file specified by the pszFileName parameter.

Return Value

If the function succeeds, the function returns zero.

If the function fails, it returns a nonzero value.

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

CARD_FILE_INFO

CardAcquireContext

Send comments about this topic to Microsoft

Build date: 3/5/2009