Inside Macintosh: Telephony /

Chapter 3 - Directory Numbers / Directory Number Reference

Directory Number Functions / Getting Information About Directory Numbers

TELGetDNStatus

Returns the current status of a directory number.

pascal TELErr TELGetDNStatus (TELDNHandle hTELDN, long *inUse);

hTELDN

A handle to a directory number structure.

inUse

On exit, a value that indicates the current state of the specified directory number. See "Directory Number States" on page 3-6 for a description of the available directory number states.

function result

A result code.

DESCRIPTION

The TELGetDNStatus function returns, in the inUse parameter, a value that indicates the current state of the directory number specified by the hTELDN parameter. For example, if TELGetDNStatus returns the value telDNNotUsed in the inUse parameter, the directory number is not in use (that is, the phone line is on hook).