VERIFYSERVERCERT (Windows Embedded CE 6.0)

1/6/2010

This callback function is an application-defined function. The server calls this function to allow a client to evaluate the certificate chain of the server to which it is connected. The VERIFYSERVERCERT name for this function is a placeholder for the function name defined by the application.

Syntax

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

Parameters

• Connection
  [in] Session handle.

• pServerCert
  [in] Server's certificate.

Return Value

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

If this function fails, the return value is FALSE and the connection with a security infrastructure is severed.

Remarks

This callback function allows the client to verify the certificate of the server. The client registers a callback, which is invoked after the connection with a security infrastructure 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 this callback function after the connection with a security infrastructure has been established. The certificate of the server is supplied for examination by the client.

Requirements

See Also

Reference

LDAP Callback Functions
ldap_set_option