Creates a selector string to use with configuration or fetch attributes and functions.

Syntax

int32 __stdcall RFmxCDMA2k_BuildSignalString(char signalName[], char resultName[], int32 selectorStringLength, char selectorString[])

Remarks

Refer to the Selector String topic for information about the string syntax for named signals.

Parameters

NameDirectionTypeDescription
signalName[in]char[]

This parameter specifies the name of the signal when using named signal configurations. This input accepts the signal name with or without the "signal::" prefix. The default value is "" (empty string).

Examples:

""

"signal::sig1"

"sig1"

resultName[in]char[]

This parameter specifies the name of the result when performing overlapped measurements. This input accepts the result name with or without the "result::" prefix. The default value is "" (empty string).

Examples:

""

"result::r1"

"r1"

selectorStringLength[in]int32

Specifies the length of the selector string. Set this parameter to 0 to get the minimum buffer size required to build the selector string.

selectorString[in]char[]

This parameter returns the selector string you can use in the input to Configuration functions, Fetch functions, or other functions that build selector strings. This string contains the signal and/or result names with their appropriate prefixes.

Examples:

"signal::sig1"

"result::r1"

"signal::sig1/result::r1"

Returns

Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxCDMA2k_GetError function.

The general meaning of the status code is as follows:

Value

Meaning

0

Success

Positive Values

Warnings

Negative Values

Errors