CertNameToStrA 関数 (wincrypt.h)

CertNameToStr 関数は、CERT_NAME_BLOB構造体のエンコードされた名前を null で終わる文字列に変換します。

文字列表現は、 RFC 1779 の識別名の仕様に従います。 この規則の例外は、以下の「備考」セクションに記載されています。

構文

DWORD CertNameToStrA(
  [in]  DWORD           dwCertEncodingType,
  [in]  PCERT_NAME_BLOB pName,
  [in]  DWORD           dwStrType,
  [out] LPSTR           psz,
  [in]  DWORD           csz
);

パラメーター

[in] dwCertEncodingType

名前のエンコードに使用された証明書エンコードの 種類 。 この値の上位 WORD に含まれるメッセージ エンコード型識別子は、この関数では無視されます。

このパラメーターには、現在定義されている次の証明書エンコードの種類を指定できます。

[in] pName

変換する CERT_NAME_BLOB 構造体へのポインター。

[in] dwStrType

このパラメーターは、出力文字列の形式を指定します。 このパラメーターは、文字列の内容の他のオプションも指定します。

このパラメーターには、次の値のいずれかを指定できます。

次のオプションを上記の値と組み合わせて、文字列の追加オプションを指定することもできます。

[out] psz

返された文字列を受け取る文字バッファーへのポインター。 このバッファーのサイズは csz パラメーターで指定します。

[in] csz

psz バッファーのサイズ (文字単位)。 サイズには、終端の null 文字を含める必要があります。

戻り値

変換された文字数 (終端の null 文字を含む) を返します。

psz が NULL または csz が 0 の場合は、変換先文字列の必要なサイズを返します。

解説

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

デコード時に順序の問題が発生する可能性を回避するために、マルチコンポーネント RNN (CN=James+O=Microsoft など) を使用することをお勧めします。 代わりに、単一値の RNN (CN=James、O=Microsoft など) の使用を検討してください。

文字列表現は、 RFC 1779 の識別名の仕様に従います。ただし、次の一覧で説明する逸脱を除きます。

• 引用符を含む名前は、二重引用符で囲まれます。
• 空の文字列は二重引用符で囲まれます。
• 連続するスペースを含む文字列は、引用符で囲まれません。
• CERT_RDN_ENCODED_BLOB型またはCERT_RDN_OCTET_STRING型の相対識別名 (RDN) 値は、16 進数で書式設定されます。
• OID に対応する X.500 名がない場合は、OID の前に "OID" プレフィックスが使用されます。
• RDN 値の先頭に空白、末尾の空白、または次のいずれかの文字が含まれている場合、RDN 値は二重引用符 ("\" ではなく) で囲まれます。
  • コンマ (,)
  • プラス記号 (+)
  • 等号 (=)
  • インチ マーク (")
  • 円記号 (/)
  • 小なり記号 (<)
  • より大きい記号 (>)
  • 番号記号 (#)
  • セミコロン (;)
• stateOrProvinceName (2.5.4.8) OID の X.500 キー名は "S" です。 この値は RFC 1779 X.500 キー名 ("ST") とは異なります。

例

この関数を使用する例については、次を参照してください。

例 C プログラム: 証明書から ASN.1 に名前を変換し、戻る。

要件

関連項目

CertRDNValueToStr

CertStrToName

データ変換関数