На главную

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

CryptSetProvParam



[New - Windows NT]

[New - Windows 95, OEM Service Release 2]
The CryptSetProvParam function lets applications customize the operations of a CSP.

BOOL CRYPTFUNC CryptSetProvParam(

HCRYPTPROV hProv,
DWORD dwParam,
BYTE *pbData,
DWORD dwFlags
);


Parameters

hProv

[in] A handle to the CSP on which to set parameters.

dwParam

[in] The parameter number to set.
When this parameter is set to PP_CLIENT_HWND, the pbData buffer should contain a DWORD value specifiying the window handle that the provider is to use when interacting directly with the user. When setting this parameter, applications should call the CryptSetProvParam function before calling CryptAcquireContext. This is necessary because many CSPs will display a user interface during the CryptAcquireContext function. Note that CSPs that do not ever display a user interface will ignore the value of this parameter.

pbData

[in] The parameter data buffer. Place the parameter data in this buffer before calling CryptSetProvParam. The form of this data will vary, depending on the parameter number.

dwFlags

[in] The flag values. This parameter is reserved for future use and should always be zero.



Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To retrieve extended error information, use the GetLastError function.
The following table lists the error codes most commonly returned by the GetLastError function. The error codes prefaced by "NTE" are generated by the particular CSP you are using.

Error Description
ERROR_INVALID_HANDLE One of the parameters specifies an invalid handle.
ERROR_BUSY The CSP context is currently being used by another process.
ERROR_INVALID_PARAMETER One of the parameters contains an invalid value. This is most often an illegal pointer.
NTE_BAD_FLAGS The dwFlags parameter is nonzero or the pbData buffer contains an invalid value.
NTE_BAD_TYPE The dwParam parameter specifies an unknown parameter.
NTE_BAD_UID The CSP context that was specified when the hKey key was created cannot be found.
NTE_FAIL The function failed in some unexpected way.


See Also

CryptAcquireContext, CryptGetProvParam, CryptSetKeyParam


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

CryptSetProvParam



[Новый - Windows NT]

[Новый - Окно 95, Выпуск Услуги OEM 2] функция CryptSetProvParam позволяет, приложения модифицируют по заказу пользователя действия CSP.

BOOL CRYPTFUNC CryptSetProvParam(

HCRYPTPROV hProv, DWORD dwParam, БАЙТ *pbData, DWORD dwFlags
);


Параметры

hProv

[in] ручка на CSP к чему устанавливать параметры.

dwParam

[in] номер параметра, чтобы устанавливаться.
Когда этот параметр установлен на PP_CLIENT_HWND, буфер pbData должен содержать величину DWORD specifiying ручка окна, что поставщик должен использовать взаимодействуя непосредственно с потребителем. При установке этого параметра, приложения должны называть функцию CryptSetProvParam перед вызовом CryptAcquireContext. Необходимо поскольку много CSPs отобразит интерфейс пользавателя в течение функции CryptAcquireContext. Отметьте, что CSPs, что когда-либо не отображать, что интерфейс пользавателя проигнорирует величину этого параметра.

pbData

[in] буфер данных параметра. Установите данные параметра в этом буфере перед вызовом CryptSetProvParam. Форма этих данных поменяет, в зависимости от номера параметра.

dwFlags

[in] величины флага. Этот параметр зарезервирован для будущего использования и должно всегда - нулевым.



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

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

Описание Ошибки
ERROR_INVALID_HANDLE Один из параметров определяет неправильную ручку.
ERROR_BUSY контекст CSP к настоящему времени используется другим процессом.
ERROR_INVALID_PARAMETER Один из параметров содержит неправильную величину. Это - чаще всего незаконный указатель.
NTE_BAD_FLAGS параметр dwFlags ненулевой или буфер pbData содержит неправильную величину.
NTE_BAD_TYPE параметр dwParam определяет неизвестный параметр.
NTE_BAD_UID контекст CSP, который был определен когда клавиша hKey была создана, не мочь быть обнаружено.
NTE_FAIL функция терпела неудачу в немного неожиданном пути.


Смотри Также

CryptAcquireContext, CryptGetProvParam, CryptSetKeyParam


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