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


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

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

Синтаксис

RPC_STATUS RpcCertGeneratePrincipalName(
  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 , чтобы освободить память для строки, содержащей имя участника.

Требования

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

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

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

RpcStringFree