Função RpcCertGeneratePrincipalNameA (rpcssl.h)
Os programas de servidor usam a função RpcCertGeneratePrincipalName
Sintaxe
RPC_STATUS RpcCertGeneratePrincipalNameA(
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 principal 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.
Valor de retorno
Essa função não retorna um valor.
Observações
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 sinalizadores
Seu aplicativo deve chamar RpcStringFree para liberar a memória da cadeia de caracteres que contém o nome principal.
Nota
O cabeçalho rpcssl.h define RpcCertGeneratePrincipalName como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows 2000 Server [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | rpcssl.h (inclua Rpc.h) |
| biblioteca | Rpcrt4.lib |
| de DLL |
Rpcrt4.dll |
Consulte também
de nomes de entidade de segurança