Compartilhar via


Função RpcCertGeneratePrincipalName (rpcssl.h)

Os programas de servidor usam a função RpcCertGeneratePrincipalName para gerar nomes de entidade de segurança para certificados de segurança.

Sintaxe

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

Parâmetros

Context

Ponteiro para o contexto de certificado de segurança.

Flags

Atualmente, o único sinalizador válido para esse parâmetro é RPC_C_FULL_CERT_CHAIN. O uso desse sinalizador faz com que o nome da entidade de segurança seja gerado em formato completo.

pBuffer

Ponteiro para um ponteiro. A função RpcCertGeneratePrincipalName define isso para apontar para uma cadeia de caracteres terminada em nulo que contém o nome principal.

Retornar valor

Essa função não retorna um valor.

Comentários

Por padrão, o nome principal que a função RpcCertGeneratePrincipalName passa para trás está no formato msstd. Para gerar um nome em formato completo, passe RPC_C_FULL_CERT_CHAIN como o valor para o parâmetro Flags .

Seu aplicativo deve chamar RpcStringFree para liberar a memória da cadeia de caracteres que contém o nome principal.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho rpcssl.h (inclua Rpc.h)
Biblioteca Rpcrt4.lib
DLL Rpcrt4.dll

Confira também

Nomes de entidade de segurança

RpcStringFree