На главную

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

WinTrustSubjectGetCertificate



[New - Windows NT]

The WinTrustSubjectGetCertificate function retrieves a specified certificate from a subject.

BOOL WinTrustSubjectGetCertificate(

LPWIN_TRUST_SIP_SUBJECT lpSubject, // pointer to description of the subject
DWORD dwCertificateIndex, // type of certificate to retrieve
LPWIN_CERTIFICATE lpCertificate, // pointer to a buffer that receives the certificate
LPDWORD lpRequiredLength // pointer to the size, in bytes, of the buffer
);


Parameters

lpSubject

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

dwCertificateIndex

Specifies the type of certificate to retrieve. You can call the WinTrustSubjectEnumCertificates function to enumerate the types of certificates that the subject contains.

lpCertificate

Pointer to buffer that receives the WIN_CERTIFICATE structure header and the associated certificate data.

lpRequiredLength

Pointer to a DWORD. On input, it specifies the size, in bytes, of the lpCertificate buffer. On output, it receives the length of the returned certificate. If the buffer is not large enough to hold the certificate, the function fails, and lpRequiredLength returns the required buffer size.



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 WinTrust implementation of the WinTrustSubjectGetCertificate function. WinTrust then calls the WinTrustSubjectGetCertificate 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 WinTrustSubjectGetCertificate function. WinTrust gets a pointer to the SIP's WinTrustSubjectGetCertificate implementation when WinTrust calls the SIP's WinTrustSipInitialize initialization function.

The LPWINTRUST_SUBJECT_GET_CERTIFICATE type is a pointer to a WinTrustSubjectGetCertificate function.

See Also

WIN_CERTIFICATE, WIN_TRUST_SIP_SUBJECT, WinTrustSipInitialize, WinTrustSubjectEnumCertificates


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

WinTrustSubjectGetCertificate



[Новый - Windows NT]

Функция WinTrustSubjectGetCertificate извлекает определенный сертификат с предмета.

BOOL WinTrustSubjectGetCertificate(

LPWIN_TRUST_SIP_SUBJECT lpSubject, // указатель в описание предмета DWORD dwCertificateIndex, // типа сертификата, чтобы извлекать LPWIN_CERTIFICATE lpCertificate, // указатель в буфер, который получает указатель сертификата LPDWORD lpRequiredLength // в размер, в байтах, буфера
);


Параметры

lpSubject

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

dwCertificateIndex

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

lpCertificate

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

lpRequiredLength

Указатель на DWORD. На вводе, это определяет размер, в байтах, буфера lpCertificate. На выходе, это получает длину возвращанного сертификата. Если буфер - не большой достаточно, чтобы держать сертификат, функция терпит неудачу, и lpRequiredLength возвращает необходимый буферный размер.



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

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

Замечания

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

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

Смотри Также

WIN_CERTIFICATE, WIN_TRUST_SIP_SUBJECT, WinTrustSipInitialize, WinTrustSubjectEnumCertificates


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