SaslGetProfilePackageA function (sspi.h)

Article
11/20/2024

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