На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

ImageEnumerateCertificates



[Now Supported on Windows NT]

The ImageEnumerateCertificates function is used to return information about the certificates currently contained in an image file.

BOOL ImageEnumerateCertificates(

IN HANDLE FileHandle,
IN DWORD TypeFilter,
OUT PDWORD CertificateCount,
IN OUT PDWORD Indices OPTIONAL,
IN OUT DWORD IndexCount OPTIONAL
);


Parameters

FileHandle

This supplies a handle to the image file to be examined. This handle must be opened for FILE_READ_DATA access.

TypeFilter

This supplies a DICE certificate section type to be used as a filter when returning certificate information. DICE_SECTION_TYPE_ANY should be passed for information on all section types present in the image.

CertificateCount

This is filled in with the number of certificates in the image containing sections of the type specified by the TypeFilter parameter. If none are found, this parameter will return zero .

Indices

This optionally provides a buffer to use to return an array of indices to the certificates containing sections of the specified type. No ordering should be assumed for the index values, nor are they guaranteed to be contiguous when DICE_SECTION_TYPE_ANY is queried.

IndexCount

This supplies the length in DWORDs of the Indices buffer. This parameter will be examined whenever Indices is present. If CertificateCount is greater than IndexCount, Indices will be filled in with the first IndexCount sections found in the image and an appropriate warning will be returned.



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 ImageEnumerateCertificates function returns information about the certificates currently contained in an image file. It has filtering capabilities which allow certificates containing sections of any single type (or of any type) to be returned.
Once the indices of interesting certificates are discovered, they can be passed into ImageGetCertificateData to obtain the actual bodies of the certificates.
Windows NT: This function is not available under Windows NT 3.51; it was introduced in Windows NT 4.0.


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

ImageEnumerateCertificates



[Теперь Поддерживанное на Windows NT]

Функция ImageEnumerateCertificates использована, чтобы возвращать информацию о сертификатах к настоящему времени содержимых в файле образа.

BOOL ImageEnumerateCertificates(

В РУЧКЕ FileHandle, В DWORD TypeFilter, PDWORD CertificateCount, В Индексах PDWORD ДОПОЛНИТЕЛЬНЫЙ, В DWORD IndexCount ДОПОЛНИТЕЛЬНЫЙ
);


Параметры

FileHandle

Это поставляет ручку в файл образа, который нужно изучаться. Эта ручка должна быть открыта для доступа FILE_READ_DATA.

TypeFilter

Это поставляет тип секции сертификата КРИСТАЛЛА, чтобы быть использованн как фильтр при возврате информации сертификата. DICE_SECTION_TYPE_ANY должен быть пройден для информации о всей секции заносят настоящему образ.

CertificateCount

Это заполнен количеством сертификатов в образе, содержащем секции типа определялся параметром TypeFilter. Если ничто не обнаружен, этот параметр возвращает нуль.

Индексы

Это дополнительно обеспечивает буфер, чтобы использоваться, чтобы возвращать массив индексов в сертификаты, содержащие секции определенного типа. Никакое упорядочение не должно быть принято для индексных величин, ни - они гарантировали, чтобы быть непрерывным когда DICE_SECTION_TYPE_ANY спрошен.

IndexCount

Это поставляет длину в DWORDs буфера Индексов. Этот параметр будет изучен всякий раз, когда Индексы присутствует. Если CertificateCount больше, чем IndexCount, Indices будет заполнен первыми секциями IndexCount обнаруженными в образе и подходящее предупреждение будет возвращано.



Обратные Величины

Если функция добивается успеха, обратная величина является ИСТИНОЙ.
Если функция терпит неудачу, тогда обратная величина ЛОЖНАЯ. Для того, чтобы извлекать расширенную информацию ошибки, назовите GetLastError.

Замечания

Функция ImageEnumerateCertificates возвращает информацию о сертификатах к настоящему времени содержимых в файле образа. Это имеет фильтруя возможности, которые допускают сертификаты, содержащие секции любого единственного типа (или любого типа), чтобы быть возвращанн.
Как только индексы интересных сертификатов будут обнаружены, они могут быть пройдены в ImageGetCertificateData, чтобы получать фактические тела сертификатов.
Windows NT: Эта функция не доступна под Windows NT 3.51; было введено в Windows NT 4.0.


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz