SmsGetToken

The SmsGetToken function retrieves a token at the specified index from the specified filter or inventory rules folder.

SMS_STATUS SmsGetToken(
  HANDLE hFilter,    // Handle to filter or inventory rules folder.
  INT iIndex,        // Index of token to retrieve.
  TOKEN *pTokenInfo  // Pointer to TOKEN structure to receive the 
                     // token information.
);
 

Parameters

hFilter

Specifies the handle to the filter or inventory rules folder from which you want to retrieve a token.

iIndex

Specifies the index of the token to retrieve.

pTokenInfo

Specifies a TOKEN structure that will receive the information about the specified token.

Return Values

The SmsGetToken function returns a status code SMS_STATUS. If successful, the function returns a status of SMS_OK. Otherwise, it returns one of the following manifest constants:

SMS_INVALID_HANDLE

The specified handle is not a valid filter handle or inventory rules folder handle.

SMS_RANGE_ERROR

The specified token index is outside of the range of tokens in the filter or inventory rules folder.

See Also

SmsGetTokenCount