Allows the RT process to register as a sponsor under the given name. This allows the functionality of the RT process to be accessed by Windows or INtime processes. A process can only register a single sponsor name. Any subsequent calls to register a sponsor name will fail with E_STATE.

BOOLEAN RegisterRtSponsor(
    LPSTR lpszSponsorName 
);

Parameters

lpszSponsorName

A zero-terminated string containing the name of the sponsor you want to register.

Return Values

TRUE

Success.

FALSE    

Failure. To determine the status, call GetLastRtError.

Status

E_OK

No exceptional conditions occurred.

E_CONTEXT

The specified sponsor name has already been used.

E_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