---
product: Chilkat
product_version: 11.7.0
language: sqlserver
language_label: SQL Server
class: Pem
license: bundle
deprecated: false
reference_html: https://www.chilkatsoft.com/refdoc/sqlserver_PemRef.html
---
# Chilkat Pem — SQL Server — v11.7.0

> Chilkat 11.7.0 · language=sqlserver · class=Pem
> Other versions: replace `11.7.0` in this URL. Other languages: `https://www.chilkatsoft.com/ai-docs/v/11.7.0/<lang>/classes/Pem.md`.
> Language-wide rules (install, unlock, error model, strings/bytes): `https://www.chilkatsoft.com/ai-docs/v/11.7.0/sqlserver/guide.md`.

## Purpose

**Load, inspect, assemble, export, and convert PEM certificate and key material.**

`Chilkat.Pem` is the Chilkat class for handling PEM-formatted certificate and key material. It can load PEM and PKCS#7 data, add certificates, private keys, public keys, CSRs, and certificate chains, retrieve individual items, remove content, control PKCS#1 vs. PKCS#8 private key output, export PEM with optional encryption and extended attributes, and convert PEM material to PFX or Java KeyStore objects.

**Load PEM and PKCS#7**

Load PEM-encoded certificates, keys, CSRs, and PKCS#7 certificate data from files, strings, or memory.

**Collect certs and keys**

Add certificates, private keys, public keys, CSRs, and certificate chains into a single PEM container.

**Retrieve individual items**

Extract selected certificates, keys, CSRs, or chains for use with `Cert`, `PrivateKey`, `PublicKey`, or related Chilkat classes.

**Private-key format control**

Choose PKCS#1 or PKCS#8 private-key output depending on the format required by the target system.

**Encrypted PEM output**

Export private-key material with password-based encryption when PEM data must be stored or transferred securely.

**Convert to PFX or JKS**

Convert PEM certificates and keys into PFX/P12 or Java KeyStore objects when another platform or API requires those container formats.

**Common pattern:** Use `Pem` when certificate and key material is packaged as one or more PEM blocks. Load the PEM, inspect or retrieve the needed items, add or remove entries as needed, then export the result as PEM, PFX/P12, or Java KeyStore data. Use `Chilkat.Cert`, `PrivateKey`, and `PublicKey` when working directly with individual objects.

For an extended overview, see [Pem Class Overview](https://www.chilkatsoft.com/pem_class_overview.asp).

## Object creation, unlocking and error handling

**Object Creation**

```sql
DECLARE @hr int
DECLARE @pem int
EXEC @hr = sp_OACreate 'Chilkat.Pem', @pem OUT
IF @hr <> 0
BEGIN
    PRINT 'Failed to create ActiveX component'
    RETURN
END

-- ... use @pem ...

EXEC @hr = sp_OADestroy @pem
```

T-SQL uses the Chilkat ActiveX through the OLE Automation stored procedures. They must be enabled once on the server (`EXEC sp_configure 'Ole Automation Procedures', 1; RECONFIGURE;`), and the Chilkat ActiveX registered must match the bitness of the SQL Server instance (64-bit for a 64-bit SQL Server). To bind to a specific major version of Chilkat, append the major version number to the ProgID, such as `sp_OACreate 'Chilkat.Pem.11'` for Chilkat v11.\*.\*.

`sp_OACreate` returns an object token (an `int`) that is passed as the first argument of every `sp_OAMethod`, `sp_OAGetProperty` and `sp_OASetProperty` call, and released with `sp_OADestroy`. Objects returned by methods (such as an `HttpResponse` or `JsonObject`) are also tokens received through an `int` OUT parameter; they must likewise be destroyed, and the OUT parameter is `NULL` when the method fails to return an object. Objects passed as arguments are passed by their token. When an OLE Automation procedure itself fails (non-zero `@hr`), `sp_OAGetErrorInfo` describes the error.

Data types: strings are `nvarchar(4000)`; integers, booleans (1 or 0) and object tokens are `int`; dates are `datetime`. In the signatures on this page, `@success`, `@iResult`, `@sResult` and the like are the OUT variables receiving a method's return value, `@iValue` / `@sValue` receive or supply a property value, and the remaining `@` variables are the method's arguments in order.

A string returned through an OUT parameter is limited to 4000 characters. For longer values, retrieve the result as a result set into a table variable instead of an OUT parameter, for example `DECLARE @tmp TABLE (outputLine ntext)` followed by `INSERT INTO @tmp EXEC sp_OAGetProperty @pem, 'LastErrorText'`. See [string length limitations for strings returned by sp_OAMethod calls](https://www.chilkatsoft.com/sql_server_nvarchar_max_limitation.asp).

Methods that pass or return raw byte arrays are not shown on this page, because `varbinary(max)` values cannot be exchanged through `sp_OAMethod` (see [varbinary(max) limitation](https://www.chilkatsoft.com/sql_server_varbinary_max_limitation.asp)). Use the `BinData`-based alternatives (methods ending in *Bd*) or the base64 / hex string-encoded variants instead. Binary *properties* (such as `LastBinaryResult`) can be retrieved as a result set into a table variable, as shown in their signatures. Asynchronous (*\*Async*) methods and event callbacks are not available from SQL Server.

Call `Global.UnlockBundle` once at the start of the program, before using this or any other Chilkat class. Any string unlocks a fully functional 30-day trial; a purchased unlock code is used in production. See `guide.md` for the exact code in SQL Server.

How failure is reported depends on the method's return type and is stated in the note under each method below. In every case the diagnostic text is in the `LastErrorText` property of the object whose method was called.

## Members common to every Chilkat class

Documented once per language in `common-members.md`; listed here so this page is self-contained.

| Property | Signature | Access | Meaning |
|---|---|---|---|
| `DebugLogFilePath` | `EXEC sp_OAGetProperty @pem, 'DebugLogFilePath', @sValue OUT EXEC sp_OASetProperty @pem, 'DebugLogFilePath', @sValue` | read/write | If set to a file path, this property logs the LastErrorText of each Chilkat method or property call to the specified file. |
| `LastBinaryResult` | `INSERT INTO @tmp EXEC sp_OAGetProperty @pem, 'LastBinaryResult'` | read-only | This property is mainly used in SQL Server stored procedures to retrieve binary data from the last method call that returned binary data. |
| `LastErrorHtml` | `EXEC sp_OAGetProperty @pem, 'LastErrorHtml', @sValue OUT` | read-only | Provides HTML-formatted information about the last called method or property. |
| `LastErrorText` | `EXEC sp_OAGetProperty @pem, 'LastErrorText', @sValue OUT` | read-only | Provides plain text information about the last called method or property. |
| `LastErrorXml` | `EXEC sp_OAGetProperty @pem, 'LastErrorXml', @sValue OUT` | read-only | Provides XML-formatted information about the last called method or property. |
| `LastMethodSuccess` | `EXEC sp_OAGetProperty @pem, 'LastMethodSuccess', @iValue OUT EXEC sp_OASetProperty @pem, 'LastMethodSuccess', @iValue` | read/write | Indicates the success or failure of the most recent method call: `1` means success, `0` means failure. |
| `LastStringResult` | `EXEC sp_OAGetProperty @pem, 'LastStringResult', @sValue OUT` | read-only | In SQL Server stored procedures, this property holds the string return value of the most recent method call that returns a string. |
| `LastStringResultLen` | `EXEC sp_OAGetProperty @pem, 'LastStringResultLen', @iValue OUT` | read-only | The length, in characters, of the string contained in the LastStringResult property. |
| `VerboseLogging` | `EXEC sp_OAGetProperty @pem, 'VerboseLogging', @iValue OUT EXEC sp_OASetProperty @pem, 'VerboseLogging', @iValue` | read/write | If set to `1`, then the contents of LastErrorText (or LastErrorXml, or LastErrorHtml) may contain more verbose information. |
| `Version` | `EXEC sp_OAGetProperty @pem, 'Version', @sValue OUT` | read-only | Version of the component/library, such as "10.1.0" |

## Member index

| Member | Kind | Signature |
|---|---|---|
| `AppendMode` | property, read/write | `EXEC sp_OAGetProperty @pem, 'AppendMode', @iValue OUT EXEC sp_OASetProperty @pem, 'AppendMode', @iValue` |
| `NumCerts` | property, read-only | `EXEC sp_OAGetProperty @pem, 'NumCerts', @iValue OUT` |
| `NumCrls` | property, read-only | `EXEC sp_OAGetProperty @pem, 'NumCrls', @iValue OUT` |
| `NumCsrs` | property, read-only | `EXEC sp_OAGetProperty @pem, 'NumCsrs', @iValue OUT` |
| `NumPrivateKeys` | property, read-only | `EXEC sp_OAGetProperty @pem, 'NumPrivateKeys', @iValue OUT` |
| `NumPublicKeys` | property, read-only | `EXEC sp_OAGetProperty @pem, 'NumPublicKeys', @iValue OUT` |
| `PrivateKeyFormat` | property, read/write | `EXEC sp_OAGetProperty @pem, 'PrivateKeyFormat', @sValue OUT EXEC sp_OASetProperty @pem, 'PrivateKeyFormat', @sValue` |
| `PublicKeyFormat` | property, read/write | `EXEC sp_OAGetProperty @pem, 'PublicKeyFormat', @sValue OUT EXEC sp_OASetProperty @pem, 'PublicKeyFormat', @sValue` |
| `AddCert` | method | `EXEC sp_OAMethod @pem, 'AddCert', @success OUT, @cert, @includeChain` |
| `AddItem` | method | `EXEC sp_OAMethod @pem, 'AddItem', @success OUT, @itemType, @encoding, @itemData` |
| `AddP7b` | method | `EXEC sp_OAMethod @pem, 'AddP7b', @success OUT, @bd` |
| `AddPrivateKey` | method | `EXEC sp_OAMethod @pem, 'AddPrivateKey', @success OUT, @privateKey` |
| `AddPrivateKey2` | method | `EXEC sp_OAMethod @pem, 'AddPrivateKey2', @success OUT, @privKey, @certChain` |
| `AddPublicKey` | method | `EXEC sp_OAMethod @pem, 'AddPublicKey', @success OUT, @pubkey` |
| `CertAt` | method | `EXEC sp_OAMethod @pem, 'CertAt', @success OUT, @index, @cert` |
| `Clear` | method | `EXEC sp_OAMethod @pem, 'Clear', @success OUT` |
| `GetEncodedItem` | method | `EXEC sp_OAMethod @pem, 'GetEncodedItem', @sResult OUT, @itemType, @itemSubType, @encoding, @index` |
| `LoadP7bFile` | method | `EXEC sp_OAMethod @pem, 'LoadP7bFile', @success OUT, @path` |
| `LoadPem` | method | `EXEC sp_OAMethod @pem, 'LoadPem', @success OUT, @pemContent, @password` |
| `LoadPemFile` | method | `EXEC sp_OAMethod @pem, 'LoadPemFile', @success OUT, @path, @password` |
| `PrivateKeyAt` | method | `EXEC sp_OAMethod @pem, 'PrivateKeyAt', @success OUT, @index, @privKey` |
| `PublicKeyAt` | method | `EXEC sp_OAMethod @pem, 'PublicKeyAt', @success OUT, @index, @pubKey` |
| `RemoveCert` | method | `EXEC sp_OAMethod @pem, 'RemoveCert', @success OUT, @index` |
| `RemovePrivateKey` | method | `EXEC sp_OAMethod @pem, 'RemovePrivateKey', @success OUT, @index` |
| `ToJksObj` | method | `EXEC sp_OAMethod @pem, 'ToJksObj', @success OUT, @aliasName, @password, @jksObj` |
| `ToPem` | method | `EXEC sp_OAMethod @pem, 'ToPem', @sResult OUT` |
| `ToPemEx` | method | `EXEC sp_OAMethod @pem, 'ToPemEx', @sResult OUT, @extendedAttrs, @noKeys, @noCerts, @noCaCerts, @encryptAlg, @password` |
| `ToPfxObj` | method | `EXEC sp_OAMethod @pem, 'ToPfxObj', @success OUT, @pfxObj` |

Deprecated members are listed at the end of this file with their replacements; do not use them in new code.

## Properties

### Pem.AppendMode

`Chilkat 11.7.0 · sqlserver · Pem · AppendMode · property · read/write · since 9.5.0.49`

```sql
EXEC sp_OAGetProperty @pem, 'AppendMode', @iValue OUT
EXEC sp_OASetProperty @pem, 'AppendMode', @iValue
```

When set to `1`, each of the Load\* methods appends to the current contents of this PEM object. When set to `0`, a Load\* method replaces the contents of this PEM object. The default is `0`.

### Pem.NumCerts

`Chilkat 11.7.0 · sqlserver · Pem · NumCerts · property · read-only · since 9.5.0.49`

```sql
EXEC sp_OAGetProperty @pem, 'NumCerts', @iValue OUT
```

The number of certificates in the loaded PEM. To get the 1st certificate, call GetCert(0).

### Pem.NumCrls

`Chilkat 11.7.0 · sqlserver · Pem · NumCrls · property · read-only · since 9.5.0.77`

```sql
EXEC sp_OAGetProperty @pem, 'NumCrls', @iValue OUT
```

The number of certificate revocation lists (CRLs) in the loaded PEM.

### Pem.NumCsrs

`Chilkat 11.7.0 · sqlserver · Pem · NumCsrs · property · read-only · since 9.5.0.50`

```sql
EXEC sp_OAGetProperty @pem, 'NumCsrs', @iValue OUT
```

The number of certificate signing requests (CSRs) in the loaded PEM.

### Pem.NumPrivateKeys

`Chilkat 11.7.0 · sqlserver · Pem · NumPrivateKeys · property · read-only · since 9.5.0.49`

```sql
EXEC sp_OAGetProperty @pem, 'NumPrivateKeys', @iValue OUT
```

The number of private keys in the loaded PEM. To get the 1st private key, call GetPrivateKey(0).

### Pem.NumPublicKeys

`Chilkat 11.7.0 · sqlserver · Pem · NumPublicKeys · property · read-only · since 9.5.0.49`

```sql
EXEC sp_OAGetProperty @pem, 'NumPublicKeys', @iValue OUT
```

The number of public keys in the loaded PEM. To get the 1st public key, call GetPublicKey(0).

### Pem.PrivateKeyFormat

`Chilkat 11.7.0 · sqlserver · Pem · PrivateKeyFormat · property · read/write · since 9.5.0.49`

```sql
EXEC sp_OAGetProperty @pem, 'PrivateKeyFormat', @sValue OUT
EXEC sp_OASetProperty @pem, 'PrivateKeyFormat', @sValue
```

Controls the format to be used for **unencrypted** private keys when writing a PEM. Possible values are `pkcs1` and `pkcs8`. (OpenSSL typically uses the `pkcs8` format.) When writing encrypted private keys to PEM, the format is always PKCS8, and the PEM header is `BEGIN ENCRYPTED PRIVATE KEY`. The default is `pkcs8`.

The PKCS1 format uses the PEM header: BEGIN RSA PRIVATE KEY.  
The PKCS8 format uses the PEM header: BEGIN PRIVATE KEY.

### Pem.PublicKeyFormat

`Chilkat 11.7.0 · sqlserver · Pem · PublicKeyFormat · property · read/write · since 9.5.0.49`

```sql
EXEC sp_OAGetProperty @pem, 'PublicKeyFormat', @sValue OUT
EXEC sp_OASetProperty @pem, 'PublicKeyFormat', @sValue
```

Controls the format to be used for public keys when writing a PEM. Possible values are `pkcs1` and `pkcs8`. (OpenSSL typically uses the `pkcs8` format.) The default is `pkcs8`.

The PKCS1 format uses the PEM header: BEGIN RSA PUBLIC KEY.  
The PKCS8 format uses the PEM header: BEGIN PUBLIC KEY.

## Methods

### Pem.AddCert

`Chilkat 11.7.0 · sqlserver · Pem · AddCert · method · since 9.5.0.49`

```sql
EXEC sp_OAMethod @pem, 'AddCert', @success OUT, @cert, @includeChain
```

Adds a certificate, and potentially the certs in its chain of authentication to the PEM. If `includeChain` is `1`, then certificates in the `cert`'s chain of authentication up to and including the root are automatically added.

Returns 1 for success, 0 for failure.

### Pem.AddItem

`Chilkat 11.7.0 · sqlserver · Pem · AddItem · method · since 9.5.0.59`

```sql
EXEC sp_OAMethod @pem, 'AddItem', @success OUT, @itemType, @encoding, @itemData
```

Adds a certificate, private key, public key, or csr to the PEM. The possible values for `itemType` are `certificate` (or `cert`), `privateKey`, `publicKey`, or `csr`. The `encoding` can be `Base64`, `modBase64`, `Base32`, `QP` (for quoted-printable), `URL` (for url-encoding), `Hex`, `url_oauth`, `url_rfc1738`, `url_rfc2396`, and `url_rfc3986`. The `itemData` contains the ASN.1 data in string format according to the encoding specified in `encoding`.

Returns 1 for success, 0 for failure.

### Pem.AddP7b

`Chilkat 11.7.0 · sqlserver · Pem · AddP7b · method · since 11.0.0`

```sql
EXEC sp_OAMethod @pem, 'AddP7b', @success OUT, @bd
```

Loads the PEM from the contents of an PKCS7 container (.p7b) contained in `bd`.

A .p7b (or .p7c) file contains a PKCS#7 container, which may include:

- One or more X.509 certificates (a certificate chain)
- Optionally, CRLs (Certificate Revocation Lists)
- No private key

Common Use: Used to bundle intermediate and root certificates for things like SSL certificate chains.

Returns 1 for success, 0 for failure.

### Pem.AddPrivateKey

`Chilkat 11.7.0 · sqlserver · Pem · AddPrivateKey · method · since 9.5.0.49`

```sql
EXEC sp_OAMethod @pem, 'AddPrivateKey', @success OUT, @privateKey
```

Adds a private key to the PEM object.

Returns 1 for success, 0 for failure.

### Pem.AddPrivateKey2

`Chilkat 11.7.0 · sqlserver · Pem · AddPrivateKey2 · method · since 9.5.0.49`

```sql
EXEC sp_OAMethod @pem, 'AddPrivateKey2', @success OUT, @privKey, @certChain
```

Adds a private key and it's associated certificate chain to the PEM object.

Returns 1 for success, 0 for failure.

### Pem.AddPublicKey

`Chilkat 11.7.0 · sqlserver · Pem · AddPublicKey · method · since 9.5.0.49`

```sql
EXEC sp_OAMethod @pem, 'AddPublicKey', @success OUT, @pubkey
```

Adds a public key to the PEM object.

Returns 1 for success, 0 for failure.

### Pem.CertAt

`Chilkat 11.7.0 · sqlserver · Pem · CertAt · method · since 11.0.0`

```sql
EXEC sp_OAMethod @pem, 'CertAt', @success OUT, @index, @cert
```

Returns in `cert` the Nth certificate from the PEM. The first certificate is at index 0.

Returns 1 for success, 0 for failure.

### Pem.Clear

`Chilkat 11.7.0 · sqlserver · Pem · Clear · method · since 9.5.0.49`

```sql
EXEC sp_OAMethod @pem, 'Clear', @success OUT
```

Removes all content from this PEM object.

Returns 1 for success, 0 for failure.

### Pem.GetEncodedItem

`Chilkat 11.7.0 · sqlserver · Pem · GetEncodedItem · method · since 9.5.0.50`

```sql
EXEC sp_OAMethod @pem, 'GetEncodedItem', @sResult OUT, @itemType, @itemSubType, @encoding, @index
```

Returns the encoded contents of the Nth item of a particular type (0-based `index`). The possible values for `itemType` are `certificate` (or `cert`), `privateKey`, `publicKey`, or `csr`. Input string args are case-insensitive. If the `itemType` is `privateKey`, the `itemSubType` may be `der` or `pkcs8`. If the `itemType` is `publicKey`, the `itemSubType` may be `der` or `pkcs1`. The `itemSubType` is ignored for other values of `itemType`. The valid `encoding` modes are `Base64`, `modBase64`, `Base32`, `Base58`, `QP` (for quoted-printable), `URL` (for url-encoding), `Hex`, `url_oauth`, `url_rfc1738`, `url_rfc2396`, and `url_rfc3986`.

Returns `NULL` on failure

### Pem.LoadP7bFile

`Chilkat 11.7.0 · sqlserver · Pem · LoadP7bFile · method · since 9.5.0.49`

```sql
EXEC sp_OAMethod @pem, 'LoadP7bFile', @success OUT, @path
```

Loads the contents of a PKCS7 container (.p7b file).

Returns 1 for success, 0 for failure.

### Pem.LoadPem

`Chilkat 11.7.0 · sqlserver · Pem · LoadPem · method · since 9.5.0.49`

```sql
EXEC sp_OAMethod @pem, 'LoadPem', @success OUT, @pemContent, @password
```

Loads the PEM from a PEM string. If encrypted, then the `password` is required for decryption. Otherwise, an empty string (or any string) may be passed for the `password`.

Returns 1 for success, 0 for failure.

### Pem.LoadPemFile

`Chilkat 11.7.0 · sqlserver · Pem · LoadPemFile · method · since 9.5.0.49`

```sql
EXEC sp_OAMethod @pem, 'LoadPemFile', @success OUT, @path, @password
```

Loads the PEM from a PEM file. If encrypted, then the `password` is required for decryption. Otherwise, an empty string (or any string) may be passed for the `password`.

Returns 1 for success, 0 for failure.

### Pem.PrivateKeyAt

`Chilkat 11.7.0 · sqlserver · Pem · PrivateKeyAt · method · since 11.0.0`

```sql
EXEC sp_OAMethod @pem, 'PrivateKeyAt', @success OUT, @index, @privKey
```

Returns in `privKey` the Nth private key from the PEM. The first private key is at index 0.

Returns 1 for success, 0 for failure.

### Pem.PublicKeyAt

`Chilkat 11.7.0 · sqlserver · Pem · PublicKeyAt · method · since 11.0.0`

```sql
EXEC sp_OAMethod @pem, 'PublicKeyAt', @success OUT, @index, @pubKey
```

Returns in `pubKey` the Nth public key from the PEM. The first public key is at index 0.

Returns 1 for success, 0 for failure.

### Pem.RemoveCert

`Chilkat 11.7.0 · sqlserver · Pem · RemoveCert · method · since 9.5.0.49`

```sql
EXEC sp_OAMethod @pem, 'RemoveCert', @success OUT, @index
```

Removes the Nth certificate from the PEM. The first certificate is at index 0.

Returns 1 for success, 0 for failure.

### Pem.RemovePrivateKey

`Chilkat 11.7.0 · sqlserver · Pem · RemovePrivateKey · method · since 9.5.0.49`

```sql
EXEC sp_OAMethod @pem, 'RemovePrivateKey', @success OUT, @index
```

Removes the Nth private key from the PEM. The first private key is at index 0.

Returns 1 for success, 0 for failure.

### Pem.ToJksObj

`Chilkat 11.7.0 · sqlserver · Pem · ToJksObj · method · since 11.0.0`

```sql
EXEC sp_OAMethod @pem, 'ToJksObj', @success OUT, @aliasName, @password, @jksObj
```

This function converts this PEM to a Java KeyStore (JKS) object and stores it in `jksObj`. If `aliasName` is provided, it will be used as the alias for the first object in the PEM (either a private key or certificate), while subsequent objects will receive autogenerated aliases. The resulting JKS will be encrypted with `password`, unless the PEM contains only certificates, in which case `password` is not used.

Returns 1 for success, 0 for failure.

### Pem.ToPem

`Chilkat 11.7.0 · sqlserver · Pem · ToPem · method · since 9.5.0.47`

```sql
EXEC sp_OAMethod @pem, 'ToPem', @sResult OUT
```

Write the PFX to a PEM formatted string. The resultant PEM will contain the private key, as well as the certs in the chain of authentication (or whatever certs are available in the PFX). For example:

```
 -----BEGIN RSA PRIVATE KEY-----
...
... the private key associated with the main certificate.
...
-----END RSA PRIVATE KEY-----
-----BEGIN CERTIFICATE-----
...
... the main certificate
...
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
...
... an intermediate CA certificate (if present)
...
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
...
... the root CA certificate
...
-----END CERTIFICATE-----
```

Returns `NULL` on failure

### Pem.ToPemEx

`Chilkat 11.7.0 · sqlserver · Pem · ToPemEx · method · since 9.5.0.49`

```sql
EXEC sp_OAMethod @pem, 'ToPemEx', @sResult OUT, @extendedAttrs, @noKeys, @noCerts, @noCaCerts, @encryptAlg, @password
```

Write the PFX to a PEM formatted string. If `extendedAttrs` is `1`, then extended properties (Bag Attributes and Key Attributes) are output. If `noKeys` is `1`, then no private keys are output. If `noCerts` is `1`, then no certificates are output. If `noCaCerts` is `1`, then no CA certs or intermediate CA certs are output. If `encryptAlg` is not empty, it indicates the encryption algorithm to be used for encrypting the private keys (otherwise the private keys are output unencrypted). The possible choices for the `encryptAlg` are `des3`, `aes128`, `aes192`, and `aes256`. (All encryption algorithm choices use CBC mode.) If the private keys are to be encrypted, then `password` is the password to be used. Otherwise, `password` may be left empty. For example:

```
Bag Attributes
    Microsoft Local Key set: <No Values>
    localKeyID: 01 00 00 00 
    friendlyName: le-2b09a3d2-9037-4a05-95cc-4d44518e8607
    Microsoft CSP Name: Microsoft RSA SChannel Cryptographic Provider
Key Attributes
    X509v3 Key Usage: 10 
 -----BEGIN RSA PRIVATE KEY-----
...
... the private key associated with the main certificate.
...
-----END RSA PRIVATE KEY-----
Bag Attributes
    localKeyID: 01 00 00 00 
    1.3.6.1.4.1.311.17.3.92: 00 08 00 00 
    1.3.6.1.4.1.311.17.3.20: C2 53 54 F3 ...
    1.3.6.1.4.1.311.17.3.71: 49 00 43 00 ...
    1.3.6.1.4.1.311.17.3.75: 31 00 42 00 ...
subject=/OU=Domain Control Validated/OU=PositiveSSL/CN=something.com
issuer=/C=GB/ST=Greater Manchester/L=Salford/O=COMODO CA Limited/CN=COMODO RSA Domain Validation Secure Server CA
-----BEGIN CERTIFICATE-----
...
... the main certificate
...
-----END CERTIFICATE-----
...
-----BEGIN CERTIFICATE-----
...
... an intermediate CA certificate (if present)
...
-----END CERTIFICATE-----
...
-----BEGIN CERTIFICATE-----
...
... the root CA certificate
...
-----END CERTIFICATE-----
```

Returns `NULL` on failure

### Pem.ToPfxObj

`Chilkat 11.7.0 · sqlserver · Pem · ToPfxObj · method · since 11.0.0`

```sql
EXEC sp_OAMethod @pem, 'ToPfxObj', @success OUT, @pfxObj
```

Converts this PEM object, which must contain at least one private key, to PKCS12 and returns the PFX in `pfxObj`. Typically, a PKCS12 file includes one private key, its associated certificate, and the certificate chain.

Returns 1 for success, 0 for failure.

## Deprecated members — do not use in new code

| Member | Kind | Deprecated in | Use instead |
|---|---|---|---|
| `GetCert` | method | before 11.6.1 | `CertAt` |
| `GetPrivateKey` | method | before 11.6.1 | `PrivateKeyAt` |
| `GetPublicKey` | method | before 11.6.1 | `PublicKeyAt` |
| `ToJks` | method | before 11.6.1 | `ToJksObj` |
| `ToPfx` | method | before 11.6.1 | `ToPfxObj` |

## Related classes

[`BinData`](https://www.chilkatsoft.com/ai-docs/v/11.7.0/sqlserver/classes/BinData.md), [`Cert`](https://www.chilkatsoft.com/ai-docs/v/11.7.0/sqlserver/classes/Cert.md), [`CertChain`](https://www.chilkatsoft.com/ai-docs/v/11.7.0/sqlserver/classes/CertChain.md), [`JavaKeyStore`](https://www.chilkatsoft.com/ai-docs/v/11.7.0/sqlserver/classes/JavaKeyStore.md), [`Pfx`](https://www.chilkatsoft.com/ai-docs/v/11.7.0/sqlserver/classes/Pfx.md), [`PrivateKey`](https://www.chilkatsoft.com/ai-docs/v/11.7.0/sqlserver/classes/PrivateKey.md), [`PublicKey`](https://www.chilkatsoft.com/ai-docs/v/11.7.0/sqlserver/classes/PublicKey.md)

