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


функция обратного вызова EVT_ACX_PIN_RETRIEVE_NAME (acxpin.h)

Функция обратного вызова EVT_ACX_PIN_RETRIEVE_NAME реализуется драйвером и вызывается, когда имя запрашивается для указанного пин-кода.

Синтаксис

EVT_ACX_PIN_RETRIEVE_NAME EvtAcxPinRetrieveName;

NTSTATUS EvtAcxPinRetrieveName(
  ACXPIN Pin,
  PUNICODE_STRING Name
)
{...}

Параметры

Pin

Объект ACXPIN, представляющий конкретный пин-код, для которого запрашивается имя.

Name

Указатель на строку Юникода, которая будет заполнена запрошенным именем пин-кода.

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

EVT_ACX_PIN_RETRIEVE_NAME возвращает STATUS_SUCCESS, если вызов выполнен успешно. В противном случае возвращается код ошибки NTSTATUS.

Замечания

ACX предварительно выделяет буфер UNICODE_STRING перед вызовом этого обратного вызова. Максимальное число wchars для имени — MAX_PATH не включая терминатор NULL. Драйвер отвечает за копирование имени в буфере и обновление структуры Юникода длину до количества байтов, используемых строкой имени, а не в том числе конца NULL.

Требования к ACX

минимальная версия ACX: 1.0

Дополнительные сведения о версиях ACX см. в обзоре версий ACX.

Требования

Требование Ценность
заголовка acxpin.h
IRQL PASSIVE_LEVEL

См. также