SaslEnumerateProfilesW function (sspi.h)

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 which 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 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