Метод ISCardCmd::get_AlternateClassId

Статья
08/14/2024

[Метод get_AlternateClassId доступен для использования в операционных системах, указанных в разделе Требования. Он недоступен для использования в Windows Server 2003 с пакетом обновления 1 (SP1) и более поздних версиях, Windows Vista, Windows Server 2008 и последующих версиях операционной системы. Модули смарт-карт предоставляют аналогичные функциональные возможности.]

Метод get_AlternateClassId получает значение идентификатора альтернативного класса. Этот метод завершится ошибкой, если альтернативный идентификатор не был задан предыдущим вызовом put_AlternateClassId.

Синтаксис

HRESULT get_AlternateClassId(
  [out] BYTE *pbyClass
);

Параметры

pbyClass [out]: Указатель на байт, содержащий значение идентификатора альтернативного класса при возврате.

Возвращаемое значение

Метод возвращает следующие возможные значения.

Код возврата	Описание
S_OK	Операция успешно завершена.
E_INVALIDARG	Недопустимый параметр pbyClass .
E_ACCESSDENIED	Идентификатор альтернативного класса ранее не был задан вызовом put_AlternateClassId.

Примеры

В следующем примере показано, как получить идентификатор альтернативного класса. В примере предполагается, что pISCardCmd является допустимым указателем на экземпляр интерфейса ISCardCmd .

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

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Окончание поддержки клиентов	Windows XP
Окончание поддержки сервера	Windows Server 2003
Заголовок	Scarddat.h
Библиотека типов	Scarddat.tlb
DLL	Scardssp.dll
IID	IID_ISCardCmd определяется как D5778AE3-43DE-11D0-9171-00AA00C18068

См. также раздел

ISCardCmd
put_AlternateClassId

Поделиться через