cwbSV_CreateServiceRecHandle

Purpose

This function creates a service record object and returns a handle to it.

Syntax

 
unsigned int CWB_ENTRY cwbSV_CreateServiceRecHandle(
                             cwbSV_ServiceRecHandle *serviceRecHandle);

Parameters

cwbSV_ServiceRecHandle * serviceRecHandle - input/output

Pointer to a cwbSV_ServiceRecordHandle where the handle will be returned. This handle should be used in subsequent calls to the service record functions.

Return Codes

The following list shows common return values.

CWB_OK

Successful completion.

CWB_INVALID_POINTER

NULL passed as handle address.

CWB_NOT_ENOUGH_MEMORY

Insufficient memory to create handle.

Usage

This handle can be used in your program to read records from an open service file and extract information from the record.