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

Функция RPC_AUTH_KEY_RETRIEVAL_FN является прототипом функции, указывающей адрес подпрограммы, предоставляемой серверным приложением, возвращающей ключи шифрования.

Синтаксис

RPC_AUTH_KEY_RETRIEVAL_FN RpcAuthKeyRetrievalFn;

void RpcAuthKeyRetrievalFn(
  void *Arg,
  RPC_WSTR ServerPrincName,
  unsigned long KeyVer,
  void **Key,
  RPC_STATUS *Status
)
{...}

Параметры

Arg

Указатель на определяемый пользователем аргумент на предоставленную пользователем функцию получения ключа шифрования. Библиотека времени выполнения RPC использует параметр Arg , предоставленный для RpcServerRegisterAuthInfo.

ServerPrincName

Указатель на имя участника, используемое для сервера при проверке подлинности удаленных вызовов процедур. Библиотека времени выполнения RPC использует параметр ServerPrincName , предоставленный rpcServerRegisterAuthInfo.

KeyVer

Значение, которое библиотека времени выполнения RPC автоматически предоставляет для параметра "ключ-версия". Если значение равно нулю, функция получения должна вернуть последний доступный ключ.

Key

Указатель на указатель на ключ проверки подлинности, возвращаемый предоставленной пользователем функцией.

Status

Указатель на состояние, возвращаемое функцией получения при вызове библиотекой времени выполнения RPC для проверки подлинности клиентского запроса RPC. Если состояние отличается от RPC_S_OK, запрос завершается ошибкой, и библиотека времени выполнения возвращает клиентскому приложению состояние ошибки.

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

None

Remarks

Функция получения ключа авторизации указывает адрес подпрограммы, предоставляемой серверным приложением, возвращающей ключи шифрования.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	rpcdce.h (включая Rpc.h)

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

RpcServerRegisterAuthInfo