Legacy Document

Inside Macintosh: Networking /

Chapter 12 - Multinode Architecture / Multinode Architecture Reference

Routines / Adding and Removing Multinode Addresses

RemoveNode

You use the RemoveNode routine to remove a multinode address that you acquired through the AddNode routine. You use the PBControl function to call the RemoveNode routine. See "Routines" on page 12-19 for a description of the PBControl function.

-->	ioCompletion	ProcPtr	A pointer to a completion routine.
<--	ioResult	OSErr	The result code.
-->	ioRefNum	Integer	The .MPP driver reference number. You must fill in this value.
-->	csCode	Integer	A routine selector. Always equal to 263 for this routine. You must fill in this value.
-->	nodeAddr	AddrBlock	An address of the multinode to be removed.

Field Description

ioCompletion

A pointer to a completion routine that you can provide. When you execute a function asynchronously, AppleTalk calls your completion routine when it completes execution of the function if you specify
a pointer to the routine as the value of this field. Specify NIL for
this field if you do not wish to provide a completion routine.
If you execute a function synchronously, AppleTalk ignores the ioCompletion field. For information about completion routines, see the chapter "Introduction to AppleTalk" in this book.

nodeAddr

The address of the multinode to be removed. You specify a value for this field in AddrBlock format. (See "The Address Block Record" on page 12-17.) The value of the aSocket field of the AddrBlock record must always be 0. Set the aNet and aNode fields to the network number and multinode ID values of the multinode to
be deleted.

DESCRIPTION

The RemoveNode routine removes the multinode address that you specify. You should remove only a multinode address using this routine; you must not attempt to remove the user node address.

ASSEMBLY-LANGUAGE INFORMATION

To execute the RemoveNode routine from assembly language, call the _Control trap macro with a value of 263 in the csCode field of the parameter block.

RESULT CODES

noErr	0	No error
paramErr	-50	Bad parameter value