CryptSetProvParam info Overview Group

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.

CryptSetProvParam info Overview Group

Parameters

Return Values

See Also