SmsGetFilterType

The SmsGetFilterType function retrieves the filter type and filter tag for the specified filter.

SMS_STATUS SmsGetFilterType(
  HANDLE hFilter,      // Handle to filter.
  DWORD *pfilterType,  // Pointer to DWORD that will receive the 
                       // filter type.
  char *pszTag         // Pointer to string that will receive the 
                       // filter tag.
);
 

Parameters

hFilter

Specifies the handle to the filter whose type you want to retrieve.

pfilterType

Points to a DWORD that receives the filter type.

pszTag

Points to a string buffer that receives the tag for the filter type.

Return Values

The SmsGetFilterType 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.

SMS_PARAMETER_ERROR

The pfilterType parameter is NULL.

SMS_MORE_DATA

The pszTag parameter is NULL.