ImageAddCertificate 関数 (imagehlp.h)

指定したファイルに証明書を追加します。

構文

BOOL IMAGEAPI ImageAddCertificate(
  [in]  HANDLE            FileHandle,
  [in]  LPWIN_CERTIFICATE Certificate,
  [out] PDWORD            Index
);

[in] FileHandle

変更するイメージファイルのハンドル。このハンドルは、FILE_READ_DATAおよびFILE_WRITE_DATAアクセスのために開く必要があります。

[in] Certificate

WIN_CERTIFICATE ヘッダーと関連するすべてのセクションへのポインター。証明書ヘッダーの Length メンバーは、このバッファーの長さを決定するために使用されます。

[out] Index

新しく追加された証明書のインデックスを受け取る変数へのポインター。

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

関数が失敗した場合、戻り値は FALSE になります。拡張エラー情報を取得するには、 GetLastError を呼び出します。

証明書は、既存の証明書の一覧の末尾に追加され、インデックスが割り当てられます。

この関数など、すべての ImageHlp 関数はシングルスレッドです。そのため、複数のスレッドからこの関数を呼び出すと、予期しない動作やメモリ破損が発生する可能性があります。これを回避するには、複数のスレッドからのすべての同時呼び出しをこの関数に同期する必要があります。