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