CertCreateCTLEntryFromCertificateContextProperties

CertCreateCTLEntryFromCertificateContextProperties 関数は、属性が証明書コンテキストのプロパティである証明書信頼リスト (CTL) エントリを作成する。CTL エントリの SubjectIdentifier は証明書の SHA1 ハッシュである。

CertCreateCTLEntryFromCertificateContextProperties pCertContext, cOptAttr, rgOptAttr, dwFlags, pvReserved, pCtlEntry, pcbCtlEntry

pCertContext : [var] CTL の作成に使用する CERT_CONTEXT へのポインター。
cOptAttr : [int] 追加する属性の数を指定する DWORD。
rgOptAttr : [var] CTL に追加する CRYPT_ATTRIBUTE 属性の配列へのポインター。
dwFlags : [int] DWORD。チェーン構築ハッシュプロパティを属性として強制的に含めるには CTL_ENTRY_FROM_PROP_CHAIN_FLAG を指定できる。
pvReserved : [intptr] VOID へのポインター。将来の使用のために予約されている。
pCtlEntry : [var] CTL_ENTRY 構造体へのポインターのアドレス。CTL エントリを取得するには本関数を 2 回呼び出す。1 回目の呼び出しでは、このパラメーターを NULL に設定する。関数が戻ったら、pcbCtlEntry パラメーターから取得したバイト数を使用してメモリを割り当てる。再度関数を呼び出し、このパラメーターに割り当てたメモリのアドレスを設定する。
pcbCtlEntry : [var] CTL_ENTRY 構造体のために割り当てるバイト数を格納する DWORD へのポインター。バイト数を取得するには本関数を 2 回呼び出す。1 回目の呼び出しでは、このパラメーターに 0 を含む DWORD 値のアドレスを設定し、pCtlEntry パラメーターを NULL に設定する。1 回目の呼び出しが成功すると、DWORD 値には CTL_ENTRY 構造体のために割り当てる必要があるバイト数が格納される。必要なメモリを割り当て、再度関数を呼び出し、pCtlEntry パラメーターにそのメモリのアドレスを指定する。

(プラグイン / モジュール : crypt32.dll)

解説

CertCreateCTLEntryFromCertificateContextProperties
関数は、属性が証明書コンテキストのプロパティである証明書信頼リスト (CTL) エントリを作成する。CTL エントリの
SubjectIdentifier は証明書の SHA1 ハッシュである。

[戻り値]
関数が成功した場合、関数は 0 以外 (TRUE) を返す。関数が失敗した場合は 0 (FALSE) を返す。拡張エラー情報は
GetLastError を呼び出して取得する。

情報