CertRDNValueToStrA 関数 (wincrypt.h)

  • [アーティクル]

CertRDNValueToStr 関数は、CERT_RDN_VALUE_BLOB内の名前を null で終わる文字列に変換します。

構文

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

パラメーター

[in] dwValueType

変換する RDN 値の種類を示します。

次のいずれかの値を指定できます。

  • 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

dwValueType に適した型のCERT_RDN_VALUE_BLOBへのポインター。

[out] psz

返された文字列を受け取るバッファーへのポインター。

[in] csz

返される文字列に割り当てられたサイズ (文字単位)。 サイズには、終端の NULL 文字を含める必要があります。

戻り値

変換された文字数 (終端の NULL 文字を含む) を 返します。 psz が NULL または csz が 0 の場合は、変換先文字列の必要なサイズを返します。

注釈

psz が NULL でなく、csz が 0 でない場合、返される psz は常に null で終わる可能性のある空の文字列です。

注意

wincrypt.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして CertRDNValueToStr を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows XP [デスクトップ アプリ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ]
対象プラットフォーム Windows
ヘッダー wincrypt.h
Library Crypt32.lib
[DLL] Crypt32.dll

こちらもご覧ください

CertNameToStr

データ変換関数