INtime SDK Help
INtime SDK v7.1 > About INtime > INtime Kernel > Distributed Systems Manager > ntxFindSponsor

Runs a search for the specified sponsor based on the flags provided.

NTXLOCATION ntxFindSponsor(
    LOCATION hLocation,
LPSTR lpszSponsorName,
DWORD dwFlags ); NTXLOCATION ntxFindSponsorW( NTXLOCATION hLast, const TCHAR * SponsorName, DWORD dwFlags );


The meaning of hLocation is based upon the flags passed into the call.
A zero-terminated string containing the name of the sponsor you want to search for.
Specifies the type of search that will be run. Only the following values are allowed:
NTX_START_SEARCH - Begins at the start of the RT location list and returns the first RT node where the given sponsor name is registered.
NTX_CONTINUE_SEARCH – Begins at the next node in the location list after hLocation. Returns the next RT node where the given sponsor name is registered.
NTX_THIS_LOCATION – Only search on this node for the given sponsor name.
NTX_SPECIFIC_LOCATION – Only searches for the given sponsor name on the node specified by hLocation.


There is limited UNICODE support for some NTX calls. By defining the macro _UNICODE_NTX_MINI_ the standard calls are mapped to their wide-character equivalents.

Return Values

A valid NTXLOCATION value
Failure. To determine the status, call ntxGetLastRtError.
E_PARAM - The sponsor name was invalid
E_EXIST - The sponsor is not registered on any nodes within the search parameters


Versions Defined in Include Link to
INtime 4.0 intime/rt/include/rtdsm.h rt.h rt.lib
See Also