Inside Macintosh: Telephony /

Chapter 3 - Directory Numbers / Directory Number Reference

Directory Number Functions / Finding Directory Numbers

TELDNLookupByName

Finds a directory number by name.

pascal TELErr TELDNLookupByName (
                     TELHandle hTEL, 
                     ConstStr255Param DN, 
                     TELDNHandle *hTELDN);

hTEL

A handle to a telephone record.

DN

A pointer to a Pascal-style string that contains the name of a directory number. See page 3-14 for information about directory number names.

hTELDN

On exit, a handle to a directory number structure for the directory number having the specified name. Your application is responsible for disposing of this handle when it's done using it.

function result

A result code.

DESCRIPTION

The TELDNLookupByName function returns, in the hTELDN parameter, a handle to a directory number structure for the directory number associated with the terminal specified by the hTEL parameter that has the name specified by the DN parameter. If no directory number can be found having that name, hTELDN is set to nil.