ISCardCmd::get_AlternateClassId method

Article
01/07/2021

[The get_AlternateClassId method is available for use in the operating systems specified in the Requirements section. It is not available for use in Windows Server 2003 with Service Pack 1 (SP1) and later, Windows Vista, Windows Server 2008, and subsequent versions of the operating system. The Smart Card Modules provide similar functionality.]

The get_AlternateClassId method retrieves the value of the alternate class ID. This method will fail unless the alternate ID has been set by a previous call to put_AlternateClassId.

Syntax

HRESULT get_AlternateClassId(
  [out] BYTE *pbyClass
);

Parameters

pbyClass [out]: Pointer to the byte that contains the alternate class ID value on return.

Return value

The method returns the following possible values.

Return code	Description
S_OK	Operation was completed successfully.
E_INVALIDARG	The pbyClass parameter is not valid.
E_ACCESSDENIED	The alternate class ID has not been previously set by a call to put_AlternateClassId.

Remarks

This method applies to communications using the T=0 protocol. For more information, see put_AlternateClassId.

Examples

The following example shows how to retrieve the alternate class ID. The example assumes that pISCardCmd is a valid pointer to an instance of the ISCardCmd interface.

BYTE     byAltClassID;
HRESULT  hr;

// Retrieve the alternate class ID.
hr = pISCardCmd->get_AlternateClassId(&byAltClassID);
if (FAILED(hr))
{
  printf("Failed get_AltClassId\n");
  // Take other error handling action as needed.
}

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
End of client support	Windows XP
End of server support	Windows Server 2003
Header	Scarddat.h
Type library	Scarddat.tlb
DLL	Scardssp.dll
IID	IID_ISCardCmd is defined as D5778AE3-43DE-11D0-9171-00AA00C18068

Share via