VERIFYSERVERCERT

The VERIFYSERVERCERT function passes a certificate from the server to the client.

typedef BOOLEAN (_cdecl VERIFYSERVERCERT) (
  PLDAP Connection,
  PCCERT_CONTEXT pServerCert
);

Parameters

Connection

The session handle.

pServerCert

The server's certificate.

Return Values

If the function succeeds (the client approves the server certificate), the return value is TRUE.

If the function fails; the return value is FALSE and the secure connection is torn down.

Remarks

The VERIFYSERVERCERT callback function allows the client to verify the certificate of the server. The client registers a callback which is invoked after the secure connection is set up. The server certificate is presented to the client, which invokes it and decides whether it is acceptable. To register this callback, call ldap_set_option (conn, LDAP_OPT_SERVER_CERTIFICATE, &CertRoutine), where CertRoutine is the address of your callback function.

The server calls VERIFYSERVERCERT after the secure connection has been established. The certificate of the server is supplied for examination by the client.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 SP4 or later.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in Winldap.h.

See Also

Functions, ldap_set_option