Removes the current sponsor name from the active sponsor state. No notifications are made to dependents and the name remains in use until the sponsor is removed from all relationships.

This function removes the process registered as an active sponsor from the database. No new relationships can be made with this sponsor name. The name remains in use until the sponsor no longer appears in any dependency relationships.

NTXSTATUS ntxUnregisterSponsor(
    LPSTR lpszSponsorName
);

Parameters

lpszSponsorName

A zero-terminated string containing the name of the sponsor to be removed from the active sponsor state

Return Values

E_OK

Success.

Error code

Failure. To determine the status, call ntxGetLastRtError.

Status

E_OK 0x0000

No exceptional conditions occurred.

E_STATE

The specified sponsor name has is not the name of a current sponsor.

E_NTX_INTERNAL_ERROR

The DLL could not contact the RT kernel to complete the request.

Requirements

See Also

Distributed systems manager calls