ISCardCmd::get_AlternateClassId method

[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.

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

See also

ISCardCmd

put_AlternateClassId