CertAddEncodedCertificateToSystemStore function

The CertAddEncodedCertificateToSystemStore function opens the specified system store and adds the encoded certificate to it.

Syntax

BOOL WINAPI CertAddEncodedCertificateToSystemStore(
  _In_       LPCSTR szCertStoreName,
  _In_ const BYTE   *pbCertEncoded,
  _In_       DWORD  cbCertEncoded
);

Parameters

szCertStoreName [in]

A null-terminated string that contains the name of the system store for the encoded certificate.

pbCertEncoded [in]

A pointer to a buffer that contains the encoded certificate to add.

cbCertEncoded [in]

The size, in bytes, of the pbCertEncoded buffer.

Return value

If the function succeeds, the return value is TRUE.

If the function fails, the return value is FALSE. CertAddEncodedCertificateToSystemStore depends on the functions listed in the following remarks for error handling. Refer to those function topics for their respective error handling behaviors. For extended error information, call GetLastError.

Remarks

Internally, CertAddEncodedCertificateToSystemStore calls CertOpenSystemStore and CertAddEncodedCertificateToStore with the following parameters.

If CertAddEncodedCertificateToSystemStore obtains a handle to the specified system store, it calls CertCloseStore to close the handle before it returns.

Requirements