SaslGetProfilePackageA function (sspi.h)

The SaslGetProfilePackage function returns the package information for the specified package.

Syntax

SECURITY_STATUS SEC_ENTRY SaslGetProfilePackageA(
  [in]  LPSTR        ProfileName,
  [out] PSecPkgInfoA *PackageInfo
);

Parameters

[in] ProfileName

Unicode or ANSI string that contains the name of the SASL package.

[out] PackageInfo

Pointer to a pointer to a SecPkgInfo structure that returns the package information for the package specified by the ProfileName parameter.

Return value

If the call is completed successfully, this function returns SEC_E_OK. The following table shows some possible failure return values.

Return code Description
SEC_E_SECPKG_NOT_FOUND
The SASL profile specified by the ProfileName parameter could not be found.
SEC_E_INSUFFICIENT_MEMORY
Memory could not be allocated for the SecPkgInfo structure.

Remarks

Note

The sspi.h header defines SaslGetProfilePackage 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