HP Open Source Security for OpenVMS Volume 1: Common Data Security Architecture > Human Recognition Service (HRS) API Functions

HRS_StreamInputOutput

 » Table of Contents

 » Glossary

 » Index

NAME

CSSM_HRS_StreamInputOutput, HRS_StreamInputOutput — Passes a protocol data unit into the HRS service provider and obtains a response

SYNOPSIS

#include <hrs.h>

API

CSSM_RETURN CSSMAPI CSSM_HRS_StreamInputOutput
(CSSM_HRS_HANDLE ModuleHandle,
CSSM_DATA_PTR InMessage,
CSSM_DATA_PTR OutMessage);

SPI

CSSM_RETURN CSSMHRI HRS_StreamInputOutput
(CSSM_HRS_HANDLE ModuleHandle,
CSSM_DATA_PTR InMessage,
CSSM_DATA_PTR OutMessage);

LIBRARY

HRS Extensible Module Manager (cdsa$inhrsemm_shr.exe)

PARAMETERS

The parameter definitions are the same for the API and the SPI.

ModuleHandle (input) 

The handle of the attached HRS service provider.

InMessage (input)  

This parameter contains a protocol data unit from the partner HRS service provider.

OutMessage (output) 

This parameter contains a protocol data unit to be sent back to the partner HRS service provider. If the parameter is NULL, there is no message to return.

DESCRIPTION

This function allows the application to pass a protocol data unit into the HRS service provider from the partner HRS service provider, and to obtain a response message to return to the partner.

RETURN VALUE

A CSSM_RETURN value indicating success or specifying a particular error condition. The value CSSM_OK indicates success. All other values represent an error condition.

ERRORS

Errors are described in the CDSA Technical Standard.

CSSMERR_CSSM_NOT_INITIALIZED
CSSMERR_CSSM_FUNCTION_FAILED
CSSMERR_CSSM_FUNCTION_NOT_IMPLEMENTED
CSSMERR_CSSM_FUNCTION_INTEGRITY_FAIL