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