NAME

DL_Authenticate

SYNOPSIS

CSSM_RETURN CSSMDLI DL_Authenticate
    (const CSSM_DL_HANDLE DLHandle,
    const CSSM_DB_HANDLE DBHandle,
    const CSSM_DB_ACCESS_TYPE_PTR AccessRequest,
    const CSSM_DB_USER_AUTHENTICATION_PTR UserAuthentication)

DESCRIPTION

This function allows the caller to provide authentication credentials to the DL module at a time other than data store creation, deletion, open, import, and export. AccessRequest defines the type of access to be associated with the caller. If the authentication credential applies to access and use of a DL module in general, then the data store handle specified in the DLDBHandle must be NULL. When the authorization credential is to apply to a specific data store, the handle for that data store must be specified in the DLDBHandle pair.

PARAMETERS

DLHandle (input)

The handle that describes the add-in data storage library module used to perform this function.

DBHandle (input/optional)

The handle that describes the data store to which access is being requested. If the authentication request is authentication to the DL module in general, then the data store handle must be NULL.

AccessRequest (input)

An indicator of the requested access mode for the data store or DL module in general.

UserAuthentication (input)

The caller's credential as required for obtaining authorized access to the data store or to the DL module in general.

RETURN VALUE

A CSSM_OK return value signifies that the function completed successfully. When CSSM_FAIL is returned, an error has occurred. Use CSSM_GetError to obtain the error code.

ERRORS

CSSM_DL_INVALID_DL_HANDLE

Invalid DL handle.

CSSM_DL_INVALID_DB_HANDLE

Invalid DB handle.

CSSM_INVALID_ACCESS_MODE

Unrecognized access type.

CSSM_INVALID_AUTHENTICATION

Unrecognized or invalid authentication credential.