Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The SpGetCredentials function retrieves the primary and supplemental credentials from the user object.
Syntax
SpGetCredentialsFn Spgetcredentialsfn;
NTSTATUS Spgetcredentialsfn(
[in] LSA_SEC_HANDLE CredentialHandle,
[out] PSecBuffer Credentials
)
{...}
Parameters
[in] CredentialHandle
A handle to the credentials to be retrieved.
[out] Credentials
Pointer to a SecBuffer structure that receives the credentials.
Return value
If the function succeeds, return STATUS_SUCCESS.
If the function fails, return an NTSTATUS code indicating the reason it failed. The following lists common reasons for failure and the error codes that the function should return.
| Return code | Description |
|---|---|
|
There is not sufficient memory to retrieve the credentials. |
|
The handle is not valid. |
Remarks
SSP/APs must implement the SpGetCredentials function; however, the actual name given to the implementation is up to the developer.
A pointer to the SpGetCredentials function is available in the SECPKG_FUNCTION_TABLE structure received from the SpLsaModeInitialize function.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | ntsecpkg.h |