windows-nt/Source/XPSP1/NT/net/rras/ras/rassfm/cleartxt.h

85 lines
1.9 KiB
C
Raw Normal View History

2020-09-26 03:20:57 -05:00
///////////////////////////////////////////////////////////////////////////////
//
// Copyright (c) 1998, Microsoft Corp. All rights reserved.
//
// FILE
//
// cleartxt.h
//
// SYNOPSIS
//
// Declares functions for storing and retrieving cleartext passwords from
// UserParameters.
//
// MODIFICATION HISTORY
//
// 08/31/1998 Original version.
//
///////////////////////////////////////////////////////////////////////////////
#ifndef _CLEARTXT_H_
#define _CLEARTXT_H_
#if _MSC_VER >= 1000
#pragma once
#endif
#ifdef __cplusplus
extern "C" {
#endif
/////////
// Note: These functions return Win32 error codes, not NTSTATUS codes.
/////////
//////////
// Clears the encrypted cleartext password. The new UserParameters must be
// freed through a call to IASParmsUserParmsFree. If the cleartext password
// was not previously set, the function returns NO_ERROR and pszNewUserParms
// is set to NULL.
//////////
DWORD
WINAPI
IASParmsClearUserPassword(
IN PCWSTR szUserParms,
OUT PWSTR *pszNewUserParms
);
//////////
// Retrieves the decrypted cleartext password. The returned password must be
// freed through a call to LocalFree. If the cleartext password is not
// set, the function returns NO_ERROR and pszPassword is set to NULL.
//////////
DWORD
WINAPI
IASParmsGetUserPassword(
IN PCWSTR szUserParms,
OUT PWSTR *pszPassword
);
//////////
// Sets the encrypted cleartext password. The new UserParameters must be
// freed through a call to IASParmsUserParmsFree.
//////////
DWORD
WINAPI
IASParmsSetUserPassword(
IN PCWSTR szUserParms,
IN PCWSTR szPassword,
OUT PWSTR *pszNewUserParms
);
//////////
// Frees a UserParameters string returned by IASParmsClearUserPassword or
// IASParmsSetUserPassword.
//////////
VOID
WINAPI
IASParmsFreeUserParms(
IN LPWSTR szNewUserParms
);
#ifdef __cplusplus
}
#endif
#endif // _CLEARTXT_H_