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

Статья
03/13/2024

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

Синтаксис

RPC_STATUS RpcCertGeneratePrincipalNameW(
  PCCERT_CONTEXT Context,
  DWORD          Flags,
  RPC_WSTR       *pBuffer
);

Параметры

Context

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

Flags

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

pBuffer

Указатель на указатель. Функция RpcCertGeneratePrincipalName задает значение , указывающее на строку, завершающуюся null, которая содержит имя участника.

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

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

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

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

Примечание

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

Требования

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

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

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

RpcStringFree

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