Функция RpcCertGeneratePrincipalNameA (rpcssl.h)

Статья
11/20/2024

Серверные программы используют функцию RpcCertGeneratePrincipalName для создания имен субъектов для сертификатов безопасности.

Синтаксис

RPC_STATUS RpcCertGeneratePrincipalNameA(
  PCCERT_CONTEXT Context,
  DWORD          Flags,
  RPC_CSTR       *pBuffer
);

Параметры

Context

Указатель на контекст сертификата безопасности.

Flags

В настоящее время единственным допустимым флагом этого параметра является RPC_C_FULL_CERT_CHAIN. Использование этого флага приводит к созданию имени субъекта в полноформатном формате.

pBuffer

Указатель на указатель. Функция RpcCertGeneratePrincipalName задает для этого значение в строке, завершаемой значением NULL, содержащей имя субъекта .

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

Эта функция не возвращает значение.

Замечания

По умолчанию имя субъекта, которое функция RpcCertGeneratePrincipalName передает обратно в формате msstd. Чтобы создать имя в полноформатном формате, передайте RPC_C_FULL_CERT_CHAIN в качестве значения параметра Flags.

Приложение должно вызвать RpcStringFree, чтобы освободить память для строки, содержащей имя субъекта.

Заметка

Заголовок rpcssl.h определяет RpcCertGeneratePrincipalName как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	rpcssl.h (include Rpc.h)
библиотеки	Rpcrt4.lib
DLL	Rpcrt4.dll

См. также

имена субъектов

RpcStringFree

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