Open a TCP connection to the KMIP server at Host:port or IPAddr:port.
If both the pHost and pIPAddr parameters are set then the pIPAddr will be used and pHost ignored. Note that the defined KMIP port number is 5696. This function, and all of KMIP uses SSL to communicate with the KMIP server. The keystore passed into the initialize() call must have the proper set of certificates for the KMIP server in question.
- Parameters
-
pHost | [ in ] Fully qualified domain name of the KMIP server to connect to. |
port | [ in ] TCP port to connect to on the KMIP server. |
pCredential | [ in ] Information about the connecting client so the server can decide what the client can access. Can be NULL if the KMIP server does not require authentication for the operations to be performed. |
- Returns
Failure | P6R::eNotInitialized | A successful call to initialize() is required. |
P6R::eInvalidArg | Both pHost is NULL |
P6R::eAlreadyConn | This component already has an open connection to a KMIP server. |
P6R::eInvalidVersion | KMIP server does not support the version selected in initialize(). |
P6R::eFormatError | Parsing error occurred while parsing a KMIP server response. |
P6R::eX509CertSelfSignedCertInChain | The keystore in use does not have the required certificates to make an SSL connection to the KMIP server. |