CryptMsgEncodeAndSignCTL 関数 (wincrypt.h)

[アーティクル]
03/03/2024

CryptMsgEncodeAndSignCTL 関数は、CTL をエンコードし、エンコードされた CTL を含む署名付きメッセージを作成します。

この関数は、最初に pCtlInfo が指す CTL をエンコードしてから、CryptMsgSignCTL を呼び出してエンコードされたメッセージに署名します。

構文

BOOL CryptMsgEncodeAndSignCTL(
  [in]      DWORD                    dwMsgEncodingType,
  [in]      PCTL_INFO                pCtlInfo,
  [in]      PCMSG_SIGNED_ENCODE_INFO pSignInfo,
  [in]      DWORD                    dwFlags,
  [out]     BYTE                     *pbEncoded,
  [in, out] DWORD                    *pcbEncoded
);

パラメーター

[in] dwMsgEncodingType

使用するエンコードの種類を指定します。次の例に示すように、証明書とメッセージエンコードの両方の種類をビットごとの OR 操作と組み合わせて指定することは、常に許容されます。

X509_ASN_ENCODING |PKCS_7_ASN_ENCODING

現在定義されているエンコードの種類は次のとおりです。

X509_ASN_ENCODING
PKCS_7_ASN_ENCODING

[in] pCtlInfo

エンコードおよび署名する CTL を含む CTL_INFO 構造体へのポインター。

[in] pSignInfo

CMSG_SIGNER_ENCODE_INFO構造体の配列を含むCMSG_SIGNED_ENCODE_INFO構造体へのポインター。

構造体の cbSize メンバーが構造体のサイズに設定され、他のすべてのメンバーが 0 に設定されている場合、署名者なしでメッセージをエンコードできます。

[in] dwFlags

CMSG_ENCODE_SORTED_CTL_FLAGは、エンコードの前に CTL エントリを並べ替える場合に設定されます。このフラグは、 CertFindSubjectInSortedCTL 関数または CertEnumSubjectInSortedCTL 関数が呼び出される場合に設定されます。

CMSG_ENCODE_SORTED_CTL_FLAGが設定され、TrustedSubjects の識別子が MD5 や SHA1 などのハッシュである場合、CMSG_ENCODE_HASHED_SUBJECT_IDENTIFIER_FLAGが設定されます。

CMS_PKCS7が定義されている場合、 dwFlags を CMSG_CMS_ENCAPSULATED_CTL_FLAG に設定して、CMS 互換 V3 SignedData メッセージをエンコードできます。

[out] pbEncoded

作成されたエンコードされた署名付きメッセージを受信するバッファーへのポインター。

このパラメーターは、メモリ割り当て目的でこの情報のサイズを設定するために NULL にすることができます 。詳細については、「不明な長さのデータの取得」を参照してください。

[in, out] pcbEncoded

pbEncoded バッファーのサイズをバイト単位で指定する DWORD へのポインター。関数が戻ると、 DWORD には、格納されているバイト数、またはバッファーに格納されるバイト数が含まれます。

戻り値

関数が成功した場合、戻り値は 0 以外 (TRUE) になります。

関数が失敗した場合、戻り値は 0 (FALSE) になります。詳細なエラー情報を得るには、GetLastError を呼び出します。エラーは、 CryptMsgOpenToEncode と CryptMsgUpdate への呼び出しから反映できます。

要件

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