[Now Supported on Windows NT]
The ImageAddCertificate function is used to add a DICE_CERTIFICATE to the specified file.
BOOL ImageAddCertificate(
| IN HANDLE FileHandle, | |
| IN PDICE_CERTIFICATE Certificate, | |
| OUT PDWORD Index | |
| ); |
Parameters
FileHandle
This supplies a handle to the image file to be modified. This handle must be opened for FILE_READ_DATA and FILE_WRITE_DATA access.
Certificate
This supplies a buffer containing a DICE_CERTIFICATE header and all associated sections. The Length field in the certificate header will be used to determine the length of this buffer.
Index
This returns the index of the newly added certificate.
Return Values
If the function succeeds, the return value is TRUE.
If the function fails, then the return value is FALSE. To retrieve extended error information, call GetLastError.
Remarks
The ImageAddCertificate function adds a DICE_CERTIFICATE to the specified file. The certificate is added at the end of the existing list of certificates and is assigned an index.
Windows NT: This function is not available under Windows NT 3.51; it was introduced in Windows NT 4.0.