PIV GetData() entry point for data access as defined in PIV End-Point Client-Application Programming Interface SP 800-73-4 Reads a data object from a PIV card (data) container according to Special Publication 800- 73: Data such as Card Holder Unique IDentifier (CHUID) or X509 certificates can be read without prior authentication whereas containers with biometric data require user confirmation (PIN) GetData returns the complete raw container data including TLV headers and check bytes if applicable. GetData returns NULL if the container is not accessible, is not yet initialized or contains no payload. Expiration check and CHUID signature check (optional) RID 'A0 00 00 00 01 16', container ID = 0x3000 We do not use ASN.1 object identifiers (OIDs) in the personal verification subset of the OIDs managed by NIST but rather the ObjectID as defined on APDU level. Empty containers may actually contain two bytes 0x5300

Namespace: CardWerk.SmartCard.CardModule.PIV
Assembly: CardWerk.SmartCard.CardModule.PIV (in CardWerk.SmartCard.CardModule.PIV.dll)

Public Function GetData( _ 
ByVal vbObjectId As Byte() _ 
) As Byte()
This language is not supported or no code example is available.
public byte[] GetData( 
byte[] vbObjectId 
)
This language is not supported or no code example is available.
public:  
array< Byte >^ GetData( 
array< Byte >^ vbObjectId 
)
This language is not supported or no code example is available.
public function GetData( 
vbObjectId : byte[] 
) : byte[];
This language is not supported or no code example is available.

Parameters

vbObjectId
Type: byte[]

Object ID as defined in PIV standard.

Return Value

Type: byte[]

Byte array with raw container data including TLV header and check byte. Returns null if container is empty.

Exception type Condition

SmartCardApiException

Thrown when a Smart Card API error condition occurs.

Exception

Thrown when an exception error condition occurs.

ArgumentNullException

Thrown when one or more required arguments are null.

.NET Framework

Supported in: 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

.NET Core

Supported in: 2.0, 2.1, 2.2, 3.0, 3.1, 5.0, 6.0, 7.0

.NET Standard

Supported in: 2.0