FindSemaphore

Finds a semaphore by name.

Synopsis

Item FindSemaphore( const char *name )

Description

This macro finds a semaphore with the specified name. The search is not case-sensitive (that is, the kernel does not distinguish uppercase and lowercase letters in semaphore names). You can use this macro in place of FindNamedItem() to find a semaphore.

For information about semaphores, which are used to control access to shared resources, see the "Sharing System Resources" chapter in the 3DO Portfolio Programmer's Guide.

Arguments

name
The name of the semaphore to find.

Return Value

The macro returns the item number of the semaphore that was found or an error code if an error occurs.

Implementation

Macro implemented in semaphore.h V20.

Associated Files

semaphore.h
ANSI C Macro

See Also

CreateSemaphore()