INtime SDK Help
ntxFindSponsor
INtime SDK v7 > 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 );

Parameters

hLocation
The meaning of hLocation is based upon the flags passed into the call.
lpszSponsorName
A zero-terminated string containing the name of the sponsor you want to search for.
dwFLags
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.

Remarks

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
Success.
NTX_UNDEFINED_LOCATION
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

Requirements

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