Deprecated Gestalt Manager Functions

A function identified as deprecated has been superseded and may become unsupported in the future.

Deprecated in Mac OS X v10.3

NewGestalt

Adds a selector code to those already recognized by Gestalt. (Deprecated in Mac OS X v10.3. Use NewGestaltValue instead.)

OSErr NewGestalt (
   OSType selector,
   SelectorFunctionUPP gestaltFunction
);

Parameters

selector: The selector code you want to add. This should be a four-character sequence similar to those defined in “Gestalt Manager Constants.”
gestaltFunction: A universal procedure pointer (UPP) to the selector callback function that Gestalt executes when it receives the new selector code. See SelectorFunctionProcPtr for more information on the callback you need to provide.

Return Value

A result code. See “Gestalt Manager Result Codes.”

Discussion

The NewGestalt function registers a specified selector code with the Gestalt Manager so that when the Gestalt function is called with that selector code, the specified selector function is executed. Before calling NewGestalt, you must define a selector function callback. See SelectorFunctionProcPtr for a description of how to define your selector function.

Registering with the Gestalt Manager is a way for software such as system extensions to make their presence known to potential users of their services.

Special Considerations

You should avoid using the NewGestalt function to add a selector code, which requires moving your selector function into the system heap. Applications do not have access to the system heap in Mac OS X.

Availability

Available in Mac OS X v10.0 and later.
Deprecated in Mac OS X v10.3.
Not available to 64-bit applications.

Declared In

Gestalt.h

ReplaceGestalt

Replaces the selector function associated with an existing selector code. (Deprecated in Mac OS X v10.3. Use NewGestaltValue instead.)

OSErr ReplaceGestalt (
   OSType selector,
   SelectorFunctionUPP gestaltFunction,
   SelectorFunctionUPP *oldGestaltFunction
);