SaslEnumerateProfilesW function (sspi.h)

Article
11/20/2024

The SaslEnumerateProfiles function lists the packages that provide a SASL interface.

Syntax

SECURITY_STATUS SEC_ENTRY SaslEnumerateProfilesW(
  [out] LPWSTR *ProfileList,
  [out] ULONG  *ProfileCount
);

Parameters

[out] ProfileList

Pointer to a list of Unicode or ANSI strings that contain the names of the packages with SASL wrapper support.

[out] ProfileCount

Pointer to an unsigned LONG value that contains the number of packages with SASL wrapper support.

Return value

If the call is completed successfully, this function returns SEC_E_OK.

If the function fails, the return value is a nonzero error code.

Remarks

The current list is maintained in the registry under

SYSTEM
   CurrentControlSet
      Control
         SecurityProviders
            SaslProfiles

A terminating NULL character is appended to the end of the list.

Note

The sspi.h header defines SaslEnumerateProfiles as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that is not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement	Value
Minimum supported client	None supported
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	sspi.h (include Security.h)
Library	Secur32.lib
DLL	Secur32.dll

Share via