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

Статья
02/26/2024

Функция обратного вызова 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 перед вызовом этого обратного вызова. Максимальное число символов для имени равно MAX_PATH не включая признак конца NULL. Драйвер отвечает за копирование имени в буфер и обновление поля Длина структуры Юникода до количества байтов, используемых строкой имени, не включая признак конца NULL.

Требования ACX

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

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

Требования

Требование	Значение
Заголовок	acxpin.h
IRQL	PASSIVE_LEVEL

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

[заголовок acxpin.h] (index.md)

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