Creating the New Functionality

The following functions are among the CryptoAPI functions that can be extended.

CryptoAPI functionOID function name defineOID function name string
CryptEncodeObject CRYPT_OID_ENCODE_

OBJECT_FUNC

"CryptDllEncodeObject"
CryptDecodeObject CRYPT_OID_DECODE_

OBJECT_FUNC

"CryptDllDecodeObject"
CertOpenStore CRYPT_OID_OPEN_

STORE_PROV_FUNC

"CertDllOpenStoreProv"
CertVerifyCTLUsage CRYPT_OID_VERIFY_

CTL_USAGE_FUNC

"CertDllVerifyCTLUsage"
CertVerifyRevocation CRYPT_OID_VERIFY_

REVOCATION_FUNC

"CertDllVerifyRevocation"

 

In normal use with an existing OID and encoding type, the code in the CryptoAPI function, itself, is used. If one of these functions is called with an OID and encoding type that code in the CryptoAPI function was not designed to handle, a new function, containing the new functionality, must be created in a DLL. That DLL must be registered in the registry or installed in memory.

When one of the listed functions is called with the newly designated OID and encoding type, the code in the new DLL is used rather than the code provided as part of the CryptoAPI function.

The name of the newly developed function can be the name listed under "OID function name string" in the previous table or a different name can be given when the new function code is registered.

The new function must use an appropriate prototype. In all cases except for CertOpenStore, this prototype is the same as the CryptoAPI function that calls the new function. In the case of CertOpenStore the prototype is as follows.


#include <windows.h>

BOOL WINAPI CertDllOpenStoreProv(
  IN LPCSTR lpszStoreProvider,
  IN DWORD dwEncodingType,
  IN HCRYPTPROV hCryptProv,
  IN DWORD dwFlags,
  IN const void *pvPara,
  IN HCERTSTORE hCertStore,
  IN OUT PCERT_STORE_PROV_INFO pStoreProvInfo
);


Note  If the prototypes do not match, the system stack will be corrupted.

In addition to providing the code for the new function in a DLL, extending the functionality of CryptEncodeObject or CryptDecodeObject requires a type definition for the new C data structure to be placed in a header file included when the user's program is compiled.

 

 

Community Additions

ADD
Show:
© 2014 Microsoft