Função CertRDNValueToStrA (wincrypt.h)

  • Artigo

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

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 valor pode ser um dos seguintes:

  • 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 dwValueType.

[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 NULL de terminação.

Retornar valor

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

Comentários

Se psz não for NULL e csz não for zero, o psz retornado sempre será uma cadeia de caracteres terminada em nulo possivelmente vazia.

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho wincrypt.h
Biblioteca Crypt32.lib
DLL Crypt32.dll

Confira também

CertNameToStr

Funções de conversão de dados