Novell Documentation: Novell Certificate Server Libraries for C

4.10 NPKIGetServerInfo Defines and Flags

4.10.1 Server Information Flags

The following flags are used to specify which set of information to obtain by calling NPKIGetServerInfo. For sample code, see GetServerInfo.

Value	Name	Description
0x01	PKI_CA_INFO	Use when querying for information about creating or using a certificate authority.
0x02	PKI_USER_INFO	Use when querying for information about creating a user certificate.
0x03	PKI_SERVER_INFO	Use querying for information about creating a server certificate.

4.10.2 Key Generation Algorithms Defines

One of the following values will be returned in the keyGenerationAlgorithms parameter by a successful call to NPKIGetServerInfo. (Currently, only the RSA algorithm is supported.)

Value	Name	Description
0x01	PKI_RSA_ALGORITHM	The RSA algorithm is supported.

4.10.3 Signing Algorithms Defines

One of the following values will be returned in the signingAlgorithms parameter by a successful call to NPKIGetServerInfo. (Currently only RSA algorithms are supported.)

Value	Name	Description
0x00	PKI_UNKNOWN_ALGORITHM	The algorithm is unknown and not supported.
0x01	PKI_SIGN_WITH_RSA_AND_MD2	The MD2 with RSA encryption signing algorithm is supported.
0x02	PKI_SIGN_WITH_RSA_AND_MD5	The MD5 with RSA encryption signing algorithm is supported.
0x04	PKI_SIGN_WITH_RSA_AND_SHA1	The SHA1 with RSA encryption signing algorithm is supported.

4.10.4 Key Pair Storage Defines

The following flags are used to specify which set of information to return from a successful call to NPKIStoreUserCertificate.

Value	Name	Description
0x00000001	PKI_INTERNAL_KEY_PAIR	The key pair was generated by Novell PKI service and the private key is stored in eDirectory™.
0x00000002	PKI_EXTERNAL_KEY_PAIR	The key pair was generated external to the Novell PKI service.
0x00004000	PKI_DONT_CHECK_NICKNAME_UNIQUENESS	It is allowable to have more than one user certificate belonging to a user with the same nickname.

4.10.5 CA Operational Defines

One of the following values is returned in the caOperational parameter by a successful call to NPKIGetServerInfo.

Value	Name	Description
0x00	PKI_NO_CA	A CA is either not installed and/or not operational on the specified server.
0x01	PKI_ORGANIZATIONAL_CA	An organizational CA is installed and operational on the specified server.
0x02	PKI_SUB_ORGANIZATIONAL_CA	An organizational CA is installed and operational on the specified server (currently not supported).