Registers the calling process as a Sponsor with the given name.

This function allows the Windows Process to register as a sponsor under the given name. This allows other processes to register as dependent on this process. A process can only register a single sponsor name. Any subsequent calls to register a sponsor name will fail with E_STATE.

NTXSTATUS ntxRegisterSponsor( 
    LPSTR lpszSponsorName 
);

Parameters

Return Values

E_OK

Success.

Error code

Failure. To determine the status, call ntxGetLastRtError

Status

E_OK

No exceptional conditions occurred.

E_CONTEXT

The specified sponsor name has already been used.

E_NTX_INTERNAL_ERROR

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

E_STATE

The process has already registered a sponsor name.

Requirements