На главную

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

WinTrustProviderVerifyTrust



[New - Windows NT]

The WinTrustProviderVerifyTrust function performs a specified verification action on a specified subject. When an application calls the WinVerifyTrust function, WinTrust calls the WinTrustProviderVerifyTrust function of the trust provider that supports the specified action identifier.

LONG WinTrustProviderVerifyTrust(

HWND hwnd, // handle to a window for interacting with the user
GUID *ActionID, // pointer to a trust provider action identifier
LPVOID ActionData // pointer to an action-specific data structure
);


Parameters

hwnd

Handle to the caller's window. The trust provider can use this value to determine whether it can interact with the user to perform the verification operation indicated by the action identifier. However, trust providers typically perform verification operations without input from the user. This parameter can be one of the following values.

Value Meaning
INVALID_HANDLE_VALUE There is no interactive user. The trust provider performs the verification operation without the user's assistance.
zero The trust provider can use the interactive desktop to display its user interface.
A valid window handle The trust provider can assume that any value other than zero or INVALID_HANDLE_VALUE is a valid window handle that it can use to interact with the user.


ActionID

Pointer to a GUID structure that identifies the action to perform. Each trust provider supports a unique set of action identifiers. The trust provider determines whether the subject identified by the ActionData parameter is trusted for the specified action.

ActionData

Pointer to a buffer that contains information that the trust provider needs to process the specified action identifier. Typically, the data in the buffer includes information that identifies the subject that the trust provider must evaluate. The format and contents of the buffer depend on the action identifier and the trust provider.



Return Values

If the trust provider verifies that the subject is trusted for the specified action, the return value is ERROR_SUCCESS.
Otherwise, the return value is a status code that indicates the error that occurred. For example, a trust provider might indicate that the subject is not trusted, or is trusted but with limitations or warnings. The return value can be a trust-provider - specific value described in the documentation for an individual trust provider, or it can be one of the following error codes defined in WINERROR.H.

Value Meaning
TRUST_E_SUBJECT_NOT_TRUSTED The subject is not trusted for the specified action. Most trust providers return a more detailed error code that describes the reason that the subject is not trusted.
TRUST_E_ACTION_UNKNOWN The trust provider does not support the specified action.
TRUST_E_SUBJECT_FORM_UNKNOWN The trust provider does not support the form specified for the subject.


Remarks

Each trust provider DLL must implement the WinTrustProviderVerifyTrust function. WinTrust gets a pointer to the trust provider's WinTrustProviderVerifyTrust implementation when WinTrust calls the trust provider's WinTrustProviderClientInitialize initialization function.
A trust provider's WinTrustProviderVerifyTrust function executes in the process of the application that called the WinVerifyTrust function. The function also executes in the security context of the application.

The LPWINTRUST_PROVIDER_VERIFY_TRUST type is a pointer to a WinTrustProviderVerifyTrust function.

See Also

GUID, WinTrustProviderClientInitialize, WinVerifyTrust


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

WinTrustProviderVerifyTrust



[Новый - Windows NT]

Функция WinTrustProviderVerifyTrust выполняет определенное действие проверки на определенном предмете. Когда приложение называет функцию WinVerifyTrust, WinTrust называет функцию WinTrustProviderVerifyTrust поставщика доверия, которая поддерживает определенный идентификатор действия.

ДОЛГО (ДЛИНОЙ) WinTrustProviderVerifyTrust(

HWND hwnd, // РУЧКА в окно чтобы взаимодействовать с пользователем GUID *ActionID, // указатель в идентификатор действия поставщика указателя доверия LPVOID ActionData // в действие-специфическую структуру данных
);


Параметры

hwnd

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

Значение Величины
INVALID_HANDLE_VALUE Нет диалогового пользователя. Поставщик доверия выполняет операцию проверки без помощи пользователя.
нуль поставщик доверия может использовать диалоговую настольную систему, чтобы отображать свой интерфейс пользавателя.
Правильная ручка окна поставщик доверия может допустить что любая величина кроме нуля или INVALID_HANDLE_VALUE - правильная ручка окна, которую он может использовать, чтобы взаимодействовать с пользователем.


ActionID

Указатель в структуру GUID, которая идентифицирует действие, чтобы выполняться. Каждый поставщик доверия поддерживает уникальную установку идентификаторов действия. Поставщик доверия определяет независимо предмет идентифицированный параметром ActionData поверен для определенного действия.

ActionData

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



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

Если поставщик доверия проверяет, что предмет поверен для определенного действия, обратная величина - ERROR_SUCCESS.
В противном случае, обратная величина является кодом статуса, который указывает ошибку, что происходил. Например, поставщик доверия мог указать, что предмет не поверен, или поверен но с ограничениями или предупреждениями. Обратная величина может быть доверием-поставщиком - специфическая величина описывалась в документации для индивидуального поставщика доверия, или это может быть одного из следующих кодов ошибки определенных в WINERROR.H.

Значение Величины
TRUST_E_SUBJECT_NOT_TRUSTED предмет не поверен для определенного действия. Наиболее поставщики доверия возвращают более подробный код ошибки, который описывает причину того, что предмет не поверен.
TRUST_E_ACTION_UNKNOWN поставщик доверия не поддерживает определенное действие.
TRUST_E_SUBJECT_FORM_UNKNOWN поставщик доверия не поддерживает форму определенную для предмета.


Замечания

Каждый поставщик доверия DLL должен осуществить функцию WinTrustProviderVerifyTrust. WinTrust ПОЛУЧАЕТ указатель поставщику доверия WinTrustProviderVerifyTrust реализации когда WinTrust называет поставщика доверия WinTrustProviderClientInitialize функции инициализации.
Поставщик доверия WinTrustProviderVerifyTrust функции выполняется в процессе приложения, которое было названо функция WinVerifyTrust. Функция также выполняется в контексте безопасности приложения.

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

Смотри Также

GUID, WinTrustProviderClientInitialize, WinVerifyTrust


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