Função CertRDNValueToStrA (wincrypt.h)

Artigo
11/20/2024

A função CertRDNValueToStr converte um nome em um CERT_RDN_VALUE_BLOB em uma cadeia de caracteres nulaterminada.

Sintaxe

DWORD CertRDNValueToStrA(
  [in]  DWORD                dwValueType,
  [in]  PCERT_RDN_VALUE_BLOB pValue,
  [out] LPSTR                psz,
  [in]  DWORD                csz
);

Parâmetros

[in] dwValueType

Indica o tipo de valor RDN a ser convertido.

Esse pode ser um dos seguintes valores:

CERT_RDN_ANY_TYPE
CERT_RDN_ENCODED_BLOB
CERT_RDN_OCTET_STRING
CERT_RDN_NUMERIC_STRING
CERT_RDN_PRINTABLE_STRING
CERT_RDN_TELETEX_STRING
CERT_RDN_T61_STRING
CERT_RDN_VIDEOTEX_STRING
CERT_RDN_IA5_STRING
CERT_RDN_GRAPHIC_STRING
CERT_RDN_VISIBLE_STRING
CERT_RDN_ISO646_STRING
CERT_RDN_GENERAL_STRING
CERT_RDN_UNIVERSAL_STRING
CERT_RDN_INT4_STRING
CERT_RDN_BMP_STRING
CERT_RDN_UNICODE_STRING
CERT_RDN_UTF8_STRING

[in] pValue

Um ponteiro para um CERT_RDN_VALUE_BLOB de um tipo apropriado para odwValueType .

[out] psz

Um ponteiro para um buffer para receber a cadeia de caracteres retornada.

[in] csz

Tamanho, em caracteres, alocado para a cadeia de caracteres retornada. O tamanho deve incluir o caractere de NULL terminação.

Valor de retorno

Retorna o número de caracteres convertidos, incluindo o caractere de NULL terminação. Se psz for NULL ou csz for zero, retornará o tamanho necessário da cadeia de caracteres de destino.

Observações

Se psz não estiver NULL e csz não for zero, o psz de retornado sempre será uma cadeia de caracteresterminada nula.

Nota

O cabeçalho wincrypt.h define CertRDNValueToStr 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 XP [aplicativos da área de trabalho \| Aplicativos UWP]
servidor com suporte mínimo	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
da Plataforma de Destino	Windows
cabeçalho	wincrypt.h
biblioteca	Crypt32.lib
de DLL	Crypt32.dll

Consulte também

CertNameToStr

Funções de conversão de dados

Compartilhar via