На главную

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 | Скачать Вниз

WinTrustSubjectEnumCertificates



[New - Windows NT]

The WinTrustSubjectEnumCertificates function determines the types of certificates bundled within a subject. You can retrieve a list of all the certificate types that the subject contains, or you can determine whether the subject contains a specified certificate type.

BOOL WinTrustSubjectEnumCertificates(

LPWIN_TRUST_SIP_SUBJECT lpSubject, // pointer to description of the subject
DWORD dwTypeFilter, // type of certificate to enumerate
LPDWORD lpCertificateCount, // receives number of certificates of the specified type
LPDWORD lpIndices, // pointer to an array that receives the certificate types
DWORD dwIndexCount // size of the array
);


Parameters

lpSubject

Pointer to a WIN_TRUST_SIP_SUBJECT structure that identifies the subject from which to get certificate information.

dwTypeFilter

Specifies the type of certificate to list. This parameter can be zero to list certificates of all types, or it can be one of the following values.

Value Meaning
WIN_CERT_TYPE_X509 The certificate contains an X.509 Certificate.
WIN_CERT_TYPE_PKCS_SIGNED_DATA The certificate contains a PKCS SignedData structure.
WIN_CERT_TYPE_RESERVED_1 Reserved.


lpCertificateCount

Pointer to a DWORD that receives the number of certificates of the specified type in the subject identified by lpSubject. This value indicates the number that could be returned even if the lpIndices array is not large enough to hold them all.

lpIndices

Pointer to an array of DWORD values that receives a list of WIN_CERT_TYPE_xxx values indicating the types of certificates bundled within the subject. You can use these certificate type values in the WinTrustSubjectGetCertificate function to retrieve the actual certificates.
The value returned in lpCertificateCount indicates the number of valid entries returned in the array. If dwIndexCount is less than the value returned in lpCertificateCount, the array contains garbage, and you need to call WinTrustSubjectEnumCertificates again with a larger array.

dwIndexCount

Indicates the number of entries that can be returned in the lpIndices array.



Return Values

If the function succeeds, the return value is a nonzero value.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

A trust provider calls the WinTrustSubjectEnumCertificates function to retrieve the types of certificates in the specified subject. The trust provider calls the WinTrust implementation of this function. WinTrust then calls the WinTrustSubjectEnumCertificates implementation of the appropriate Subject Interface Package (SIP). The appropriate SIP is the one registered to handle the type of subject specified by the lpSubject parameter.
Each Subject Interface Package (SIP) DLL must implement the WinTrustSubjectEnumCertificates function. WinTrust gets a pointer to the SIP's WinTrustSubjectEnumCertificates implementation when WinTrust calls the SIP's WinTrustSipInitialize initialization function.

The LPWINTRUST_SUBJECT_ENUM_CERTIFICATES type is a pointer to a WinTrustSubjectEnumCertificates function.

See Also

WIN_TRUST_SIP_SUBJECT, WinTrustSipInitialize


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

WinTrustSubjectEnumCertificates



[Новый - Windows NT]

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

BOOL WinTrustSubjectEnumCertificates(

LPWIN_TRUST_SIP_SUBJECT lpSubject, // указатель в описание предмета DWORD dwTypeFilter, // типа сертификата, чтобы перечислять LPDWORD lpCertificateCount, // количество приемников сертификатов определенного типа LPDWORD lpIndices, // указателя в массив, который получает типы сертификата DWORD dwIndexCount // размер массива
);


Параметры

lpSubject

Указатель в структуру WIN_TRUST_SIP_SUBJECT, которая идентифицирует предмет из которого, чтобы получать информацию сертификата.

dwTypeFilter

Определяет тип сертификата, чтобы указываться. Этот параметр может быть нулем, чтобы указывать сертификаты всех типов, или это может быть одним из следующего величин.

Значение Величины
WIN_CERT_TYPE_X509 сертификат содержит Сертификат X.509.
WIN_CERT_TYPE_PKCS_SIGNED_DATA сертификат содержит структуру PKCS SignedData.
WIN_CERT_TYPE_RESERVED_1 Зарезервирован.


lpCertificateCount

Указатель на DWORD, которое получает количество сертификатов определенного типа в предмете идентифицированном lpSubject. Эта величина указывает число, которое могло бы быть возвращано даже если бы массив lpIndices - не большой достаточно, чтобы держать их все.

lpIndices

Указатель в массив DWORD оценивает, что получает список величин WIN_CERT_TYPE_xxx, указывающих, что типы сертификатов связывались в узел в пределах предмета. Вы можете использовать этот сертификат заносить величинам функцию WinTrustSubjectGetCertificate, чтобы извлекать фактические сертификаты.
Величина возвращанная в lpCertificateCount указывает номер правильных данных возвращанных в массив. Если dwIndexCount - менее чем величина возвращанная в lpCertificateCount, массив содержит мусор, и, Вам нужно называть WinTrustSubjectEnumCertificates снова с большим массивом.

dwIndexCount

Указывает номер данных, которые могут быть возвращаны в массив lpIndices.



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

Если функция добивается успеха, обратная величина является ненулевой величиной.
Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Замечания

Поставщик доверия называет функцию WinTrustSubjectEnumCertificates, чтобы извлекать типы сертификатов на определенный предмет. Поставщик доверия называет реализацию WinTrust этой функции. WinTrust ЗАТЕМ называет реализацию WinTrustSubjectEnumCertificates подходящего Подчиненного Пакета Интерфейса (ГЛОТОК). Подходящий ГЛОТОК - один зарегистрированное, чтобы оперировать тип предмета определенного параметром lpSubject.
Каждый Подчиненный Пакет Интерфейса (ГЛОТОК) DLL должен осуществить функцию WinTrustSubjectEnumCertificates. WinTrust ПОЛУЧАЕТ указатель в реализацию ГЛОТКА WinTrustSubjectEnumCertificates когда WinTrust называет функцию инициализации ГЛОТКА WinTrustSipInitialize.

Тип LPWINTRUST_SUBJECT_ENUM_CERTIFICATES является указателем в функцию WinTrustSubjectEnumCertificates.

Смотри Также

WIN_TRUST_SIP_SUBJECT, WinTrustSipInitialize


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