Blame winpr/include/winpr/credentials.h

Packit Service fa4841
/**
Packit Service fa4841
 * WinPR: Windows Portable Runtime
Packit Service fa4841
 * Credentials Management
Packit Service fa4841
 *
Packit Service fa4841
 * Copyright 2012 Marc-Andre Moreau <marcandre.moreau@gmail.com>
Packit Service fa4841
 *
Packit Service fa4841
 * Licensed under the Apache License, Version 2.0 (the "License");
Packit Service fa4841
 * you may not use this file except in compliance with the License.
Packit Service fa4841
 * You may obtain a copy of the License at
Packit Service fa4841
 *
Packit Service fa4841
 *     http://www.apache.org/licenses/LICENSE-2.0
Packit Service fa4841
 *
Packit Service fa4841
 * Unless required by applicable law or agreed to in writing, software
Packit Service fa4841
 * distributed under the License is distributed on an "AS IS" BASIS,
Packit Service fa4841
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
Packit Service fa4841
 * See the License for the specific language governing permissions and
Packit Service fa4841
 * limitations under the License.
Packit Service fa4841
 */
Packit Service fa4841
Packit Service fa4841
#ifndef WINPR_CREDENTIALS_H
Packit Service fa4841
#define WINPR_CREDENTIALS_H
Packit Service fa4841
Packit Service fa4841
#include <winpr/winpr.h>
Packit Service fa4841
#include <winpr/wtypes.h>
Packit Service fa4841
Packit Service fa4841
#ifndef _WIN32
Packit Service fa4841
Packit Service b1ea74
#define CRED_SESSION_WILDCARD_NAME_W L"*Session"
Packit Service b1ea74
#define CRED_SESSION_WILDCARD_NAME_A "*Session"
Packit Service b1ea74
#define CRED_SESSION_WILDCARD_NAME_LENGTH (sizeof(CRED_SESSION_WILDCARD_NAME_A) - 1)
Packit Service b1ea74
Packit Service b1ea74
#define CRED_MAX_STRING_LENGTH 256
Packit Service b1ea74
#define CRED_MAX_USERNAME_LENGTH (256 + 1 + 256)
Packit Service b1ea74
#define CRED_MAX_GENERIC_TARGET_NAME_LENGTH 32767
Packit Service b1ea74
#define CRED_MAX_DOMAIN_TARGET_NAME_LENGTH (256 + 1 + 80)
Packit Service b1ea74
#define CRED_MAX_VALUE_SIZE 256
Packit Service b1ea74
#define CRED_MAX_ATTRIBUTES 64
Packit Service b1ea74
Packit Service b1ea74
#define CRED_FLAGS_PASSWORD_FOR_CERT 0x0001
Packit Service b1ea74
#define CRED_FLAGS_PROMPT_NOW 0x0002
Packit Service b1ea74
#define CRED_FLAGS_USERNAME_TARGET 0x0004
Packit Service b1ea74
#define CRED_FLAGS_OWF_CRED_BLOB 0x0008
Packit Service b1ea74
#define CRED_FLAGS_VALID_FLAGS 0x000F
Packit Service b1ea74
Packit Service b1ea74
#define CRED_TYPE_GENERIC 1
Packit Service b1ea74
#define CRED_TYPE_DOMAIN_PASSWORD 2
Packit Service b1ea74
#define CRED_TYPE_DOMAIN_CERTIFICATE 3
Packit Service b1ea74
#define CRED_TYPE_DOMAIN_VISIBLE_PASSWORD 4
Packit Service b1ea74
#define CRED_TYPE_MAXIMUM 5
Packit Service b1ea74
#define CRED_TYPE_MAXIMUM_EX (CRED_TYPE_MAXIMUM + 1000)
Packit Service b1ea74
Packit Service b1ea74
#define CRED_MAX_CREDENTIAL_BLOB_SIZE 512
Packit Service b1ea74
Packit Service b1ea74
#define CRED_PERSIST_NONE 0
Packit Service b1ea74
#define CRED_PERSIST_SESSION 1
Packit Service b1ea74
#define CRED_PERSIST_LOCAL_MACHINE 2
Packit Service b1ea74
#define CRED_PERSIST_ENTERPRISE 3
Packit Service b1ea74
Packit Service b1ea74
#define CRED_PRESERVE_CREDENTIAL_BLOB 0x1
Packit Service b1ea74
#define CRED_CACHE_TARGET_INFORMATION 0x1
Packit Service b1ea74
#define CRED_ALLOW_NAME_RESOLUTION 0x1
Packit Service fa4841
Packit Service fa4841
typedef struct _CREDENTIAL_ATTRIBUTEA
Packit Service fa4841
{
Packit Service fa4841
	LPSTR Keyword;
Packit Service fa4841
	DWORD Flags;
Packit Service fa4841
	DWORD ValueSize;
Packit Service fa4841
	LPBYTE Value;
Packit Service fa4841
} CREDENTIAL_ATTRIBUTEA, *PCREDENTIAL_ATTRIBUTEA;
Packit Service fa4841
Packit Service fa4841
typedef struct _CREDENTIAL_ATTRIBUTEW
Packit Service fa4841
{
Packit Service fa4841
	LPWSTR Keyword;
Packit Service fa4841
	DWORD Flags;
Packit Service fa4841
	DWORD ValueSize;
Packit Service fa4841
	LPBYTE Value;
Packit Service fa4841
} CREDENTIAL_ATTRIBUTEW, *PCREDENTIAL_ATTRIBUTEW;
Packit Service fa4841
Packit Service fa4841
typedef struct _CREDENTIALA
Packit Service fa4841
{
Packit Service fa4841
	DWORD Flags;
Packit Service fa4841
	DWORD Type;
Packit Service fa4841
	LPSTR TargetName;
Packit Service fa4841
	LPSTR Comment;
Packit Service fa4841
	FILETIME LastWritten;
Packit Service fa4841
	DWORD CredentialBlobSize;
Packit Service fa4841
	LPBYTE CredentialBlob;
Packit Service fa4841
	DWORD Persist;
Packit Service fa4841
	DWORD AttributeCount;
Packit Service fa4841
	PCREDENTIAL_ATTRIBUTEA Attributes;
Packit Service fa4841
	LPSTR TargetAlias;
Packit Service fa4841
	LPSTR UserName;
Packit Service fa4841
} CREDENTIALA, *PCREDENTIALA;
Packit Service fa4841
Packit Service fa4841
typedef struct _CREDENTIALW
Packit Service fa4841
{
Packit Service fa4841
	DWORD Flags;
Packit Service fa4841
	DWORD Type;
Packit Service fa4841
	LPWSTR TargetName;
Packit Service fa4841
	LPWSTR Comment;
Packit Service fa4841
	FILETIME LastWritten;
Packit Service fa4841
	DWORD CredentialBlobSize;
Packit Service fa4841
	LPBYTE CredentialBlob;
Packit Service fa4841
	DWORD Persist;
Packit Service fa4841
	DWORD AttributeCount;
Packit Service fa4841
	PCREDENTIAL_ATTRIBUTEW Attributes;
Packit Service fa4841
	LPWSTR TargetAlias;
Packit Service fa4841
	LPWSTR UserName;
Packit Service fa4841
} CREDENTIALW, *PCREDENTIALW;
Packit Service fa4841
Packit Service fa4841
typedef struct _CREDENTIAL_TARGET_INFORMATIONA
Packit Service fa4841
{
Packit Service fa4841
	LPSTR TargetName;
Packit Service fa4841
	LPSTR NetbiosServerName;
Packit Service fa4841
	LPSTR DnsServerName;
Packit Service fa4841
	LPSTR NetbiosDomainName;
Packit Service fa4841
	LPSTR DnsDomainName;
Packit Service fa4841
	LPSTR DnsTreeName;
Packit Service fa4841
	LPSTR PackageName;
Packit Service fa4841
	ULONG Flags;
Packit Service fa4841
	DWORD CredTypeCount;
Packit Service fa4841
	LPDWORD CredTypes;
Packit Service fa4841
} CREDENTIAL_TARGET_INFORMATIONA, *PCREDENTIAL_TARGET_INFORMATIONA;
Packit Service fa4841
Packit Service fa4841
typedef struct _CREDENTIAL_TARGET_INFORMATIONW
Packit Service fa4841
{
Packit Service fa4841
	LPWSTR TargetName;
Packit Service fa4841
	LPWSTR NetbiosServerName;
Packit Service fa4841
	LPWSTR DnsServerName;
Packit Service fa4841
	LPWSTR NetbiosDomainName;
Packit Service fa4841
	LPWSTR DnsDomainName;
Packit Service fa4841
	LPWSTR DnsTreeName;
Packit Service fa4841
	LPWSTR PackageName;
Packit Service fa4841
	ULONG Flags;
Packit Service fa4841
	DWORD CredTypeCount;
Packit Service fa4841
	LPDWORD CredTypes;
Packit Service fa4841
} CREDENTIAL_TARGET_INFORMATIONW, *PCREDENTIAL_TARGET_INFORMATIONW;
Packit Service fa4841
Packit Service fa4841
typedef enum _CRED_MARSHAL_TYPE
Packit Service fa4841
{
Packit Service fa4841
	CertCredential = 1,
Packit Service fa4841
	UsernameTargetCredential
Packit Service b1ea74
} CRED_MARSHAL_TYPE,
Packit Service b1ea74
    *PCRED_MARSHAL_TYPE;
Packit Service fa4841
Packit Service fa4841
typedef enum _CRED_PROTECTION_TYPE
Packit Service fa4841
{
Packit Service fa4841
	CredUnprotected = 0,
Packit Service fa4841
	CredUserProtection = 1,
Packit Service fa4841
	CredTrustedProtection = 2
Packit Service b1ea74
} CRED_PROTECTION_TYPE,
Packit Service b1ea74
    *PCRED_PROTECTION_TYPE;
Packit Service fa4841
Packit Service fa4841
#ifdef UNICODE
Packit Service b1ea74
#define CRED_SESSION_WILDCARD_NAME CRED_SESSION_WILDCARD_NAME_W
Packit Service b1ea74
#define CREDENTIAL_ATTRIBUTE CREDENTIAL_ATTRIBUTEW
Packit Service b1ea74
#define PCREDENTIAL_ATTRIBUTE PCREDENTIAL_ATTRIBUTEW
Packit Service b1ea74
#define CREDENTIAL CREDENTIALW
Packit Service b1ea74
#define PCREDENTIAL PCREDENTIALW
Packit Service b1ea74
#define CREDENTIAL_TARGET_INFORMATION CREDENTIAL_TARGET_INFORMATIONW
Packit Service b1ea74
#define PCREDENTIAL_TARGET_INFORMATION PCREDENTIAL_TARGET_INFORMATIONW
Packit Service fa4841
#else
Packit Service b1ea74
#define CRED_SESSION_WILDCARD_NAME CRED_SESSION_WILDCARD_NAME_A
Packit Service b1ea74
#define CREDENTIAL_ATTRIBUTE CREDENTIAL_ATTRIBUTEA
Packit Service b1ea74
#define PCREDENTIAL_ATTRIBUTE PCREDENTIAL_ATTRIBUTEA
Packit Service b1ea74
#define CREDENTIAL CREDENTIALA
Packit Service b1ea74
#define PCREDENTIAL PCREDENTIALA
Packit Service b1ea74
#define CREDENTIAL_TARGET_INFORMATION CREDENTIAL_TARGET_INFORMATIONA
Packit Service b1ea74
#define PCREDENTIAL_TARGET_INFORMATION PCREDENTIAL_TARGET_INFORMATIONA
Packit Service fa4841
#endif
Packit Service fa4841
Packit Service fa4841
#ifdef __cplusplus
Packit Service b1ea74
extern "C"
Packit Service b1ea74
{
Packit Service fa4841
#endif
Packit Service fa4841
Packit Service b1ea74
	WINPR_API BOOL CredWriteW(PCREDENTIALW Credential, DWORD Flags);
Packit Service b1ea74
	WINPR_API BOOL CredWriteA(PCREDENTIALA Credential, DWORD Flags);
Packit Service fa4841
Packit Service b1ea74
	WINPR_API BOOL CredReadW(LPCWSTR TargetName, DWORD Type, DWORD Flags, PCREDENTIALW* Credential);
Packit Service b1ea74
	WINPR_API BOOL CredReadA(LPCSTR TargetName, DWORD Type, DWORD Flags, PCREDENTIALA* Credential);
Packit Service fa4841
Packit Service b1ea74
	WINPR_API BOOL CredEnumerateW(LPCWSTR Filter, DWORD Flags, DWORD* Count,
Packit Service b1ea74
	                              PCREDENTIALW** Credential);
Packit Service b1ea74
	WINPR_API BOOL CredEnumerateA(LPCSTR Filter, DWORD Flags, DWORD* Count,
Packit Service b1ea74
	                              PCREDENTIALA** Credential);
Packit Service fa4841
Packit Service b1ea74
	WINPR_API BOOL CredWriteDomainCredentialsW(PCREDENTIAL_TARGET_INFORMATIONW TargetInfo,
Packit Service b1ea74
	                                           PCREDENTIALW Credential, DWORD Flags);
Packit Service b1ea74
	WINPR_API BOOL CredWriteDomainCredentialsA(PCREDENTIAL_TARGET_INFORMATIONA TargetInfo,
Packit Service b1ea74
	                                           PCREDENTIALA Credential, DWORD Flags);
Packit Service fa4841
Packit Service b1ea74
	WINPR_API BOOL CredReadDomainCredentialsW(PCREDENTIAL_TARGET_INFORMATIONW TargetInfo,
Packit Service b1ea74
	                                          DWORD Flags, DWORD* Count, PCREDENTIALW** Credential);
Packit Service b1ea74
	WINPR_API BOOL CredReadDomainCredentialsA(PCREDENTIAL_TARGET_INFORMATIONA TargetInfo,
Packit Service b1ea74
	                                          DWORD Flags, DWORD* Count, PCREDENTIALA** Credential);
Packit Service fa4841
Packit Service b1ea74
	WINPR_API BOOL CredDeleteW(LPCWSTR TargetName, DWORD Type, DWORD Flags);
Packit Service b1ea74
	WINPR_API BOOL CredDeleteA(LPCSTR TargetName, DWORD Type, DWORD Flags);
Packit Service fa4841
Packit Service b1ea74
	WINPR_API BOOL CredRenameW(LPCWSTR OldTargetName, LPCWSTR NewTargetName, DWORD Type,
Packit Service b1ea74
	                           DWORD Flags);
Packit Service b1ea74
	WINPR_API BOOL CredRenameA(LPCSTR OldTargetName, LPCSTR NewTargetName, DWORD Type, DWORD Flags);
Packit Service fa4841
Packit Service b1ea74
	WINPR_API BOOL CredGetTargetInfoW(LPCWSTR TargetName, DWORD Flags,
Packit Service b1ea74
	                                  PCREDENTIAL_TARGET_INFORMATIONW* TargetInfo);
Packit Service b1ea74
	WINPR_API BOOL CredGetTargetInfoA(LPCSTR TargetName, DWORD Flags,
Packit Service b1ea74
	                                  PCREDENTIAL_TARGET_INFORMATIONA* TargetInfo);
Packit Service fa4841
Packit Service b1ea74
	WINPR_API BOOL CredMarshalCredentialW(CRED_MARSHAL_TYPE CredType, PVOID Credential,
Packit Service b1ea74
	                                      LPWSTR* MarshaledCredential);
Packit Service b1ea74
	WINPR_API BOOL CredMarshalCredentialA(CRED_MARSHAL_TYPE CredType, PVOID Credential,
Packit Service b1ea74
	                                      LPSTR* MarshaledCredential);
Packit Service fa4841
Packit Service b1ea74
	WINPR_API BOOL CredUnmarshalCredentialW(LPCWSTR MarshaledCredential,
Packit Service b1ea74
	                                        PCRED_MARSHAL_TYPE CredType, PVOID* Credential);
Packit Service b1ea74
	WINPR_API BOOL CredUnmarshalCredentialA(LPCSTR MarshaledCredential, PCRED_MARSHAL_TYPE CredType,
Packit Service b1ea74
	                                        PVOID* Credential);
Packit Service fa4841
Packit Service b1ea74
	WINPR_API BOOL CredIsMarshaledCredentialW(LPCWSTR MarshaledCredential);
Packit Service b1ea74
	WINPR_API BOOL CredIsMarshaledCredentialA(LPCSTR MarshaledCredential);
Packit Service fa4841
Packit Service b1ea74
	WINPR_API BOOL CredProtectW(BOOL fAsSelf, LPWSTR pszCredentials, DWORD cchCredentials,
Packit Service b1ea74
	                            LPWSTR pszProtectedCredentials, DWORD* pcchMaxChars,
Packit Service b1ea74
	                            CRED_PROTECTION_TYPE* ProtectionType);
Packit Service b1ea74
	WINPR_API BOOL CredProtectA(BOOL fAsSelf, LPSTR pszCredentials, DWORD cchCredentials,
Packit Service b1ea74
	                            LPSTR pszProtectedCredentials, DWORD* pcchMaxChars,
Packit Service b1ea74
	                            CRED_PROTECTION_TYPE* ProtectionType);
Packit Service fa4841
Packit Service b1ea74
	WINPR_API BOOL CredUnprotectW(BOOL fAsSelf, LPWSTR pszProtectedCredentials,
Packit Service b1ea74
	                              DWORD cchCredentials, LPWSTR pszCredentials, DWORD* pcchMaxChars);
Packit Service b1ea74
	WINPR_API BOOL CredUnprotectA(BOOL fAsSelf, LPSTR pszProtectedCredentials, DWORD cchCredentials,
Packit Service b1ea74
	                              LPSTR pszCredentials, DWORD* pcchMaxChars);
Packit Service fa4841
Packit Service b1ea74
	WINPR_API BOOL CredIsProtectedW(LPWSTR pszProtectedCredentials,
Packit Service b1ea74
	                                CRED_PROTECTION_TYPE* pProtectionType);
Packit Service b1ea74
	WINPR_API BOOL CredIsProtectedA(LPSTR pszProtectedCredentials,
Packit Service b1ea74
	                                CRED_PROTECTION_TYPE* pProtectionType);
Packit Service fa4841
Packit Service b1ea74
	WINPR_API BOOL CredFindBestCredentialW(LPCWSTR TargetName, DWORD Type, DWORD Flags,
Packit Service b1ea74
	                                       PCREDENTIALW* Credential);
Packit Service b1ea74
	WINPR_API BOOL CredFindBestCredentialA(LPCSTR TargetName, DWORD Type, DWORD Flags,
Packit Service b1ea74
	                                       PCREDENTIALA* Credential);
Packit Service fa4841
Packit Service b1ea74
	WINPR_API BOOL CredGetSessionTypes(DWORD MaximumPersistCount, LPDWORD MaximumPersist);
Packit Service fa4841
Packit Service b1ea74
	WINPR_API VOID CredFree(PVOID Buffer);
Packit Service fa4841
Packit Service fa4841
#ifdef __cplusplus
Packit Service fa4841
}
Packit Service fa4841
#endif
Packit Service fa4841
Packit Service fa4841
#ifdef UNICODE
Packit Service b1ea74
#define CredWrite CredWriteW
Packit Service b1ea74
#define CredRead CredReadW
Packit Service b1ea74
#define CredEnumerate CredEnumerateW
Packit Service b1ea74
#define CredWriteDomainCredentials CredWriteDomainCredentialsW
Packit Service b1ea74
#define CredReadDomainCredentials CredReadDomainCredentialsW
Packit Service b1ea74
#define CredDelete CredDeleteW
Packit Service b1ea74
#define CredRename CredRenameW
Packit Service b1ea74
#define CredGetTargetInfo CredGetTargetInfoW
Packit Service b1ea74
#define CredMarshalCredential CredMarshalCredentialW
Packit Service b1ea74
#define CredUnmarshalCredential CredUnmarshalCredentialW
Packit Service b1ea74
#define CredIsMarshaledCredential CredIsMarshaledCredentialW
Packit Service b1ea74
#define CredProtect CredProtectW
Packit Service b1ea74
#define CredUnprotect CredUnprotectW
Packit Service b1ea74
#define CredIsProtected CredIsProtectedW
Packit Service b1ea74
#define CredFindBestCredential CredFindBestCredentialW
Packit Service fa4841
#else
Packit Service b1ea74
#define CredWrite CredWriteA
Packit Service b1ea74
#define CredRead CredReadA
Packit Service b1ea74
#define CredEnumerate CredEnumerateA
Packit Service b1ea74
#define CredWriteDomainCredentials CredWriteDomainCredentialsA
Packit Service b1ea74
#define CredReadDomainCredentials CredReadDomainCredentialsA
Packit Service b1ea74
#define CredDelete CredDeleteA
Packit Service b1ea74
#define CredRename CredRenameA
Packit Service b1ea74
#define CredGetTargetInfo CredGetTargetInfoA
Packit Service b1ea74
#define CredMarshalCredential CredMarshalCredentialA
Packit Service b1ea74
#define CredUnmarshalCredential CredUnmarshalCredentialA
Packit Service b1ea74
#define CredIsMarshaledCredential CredIsMarshaledCredentialA
Packit Service b1ea74
#define CredProtect CredProtectA
Packit Service b1ea74
#define CredUnprotect CredUnprotectA
Packit Service b1ea74
#define CredIsProtected CredIsProtectedA
Packit Service b1ea74
#define CredFindBestCredential CredFindBestCredentialA
Packit Service fa4841
#endif
Packit Service fa4841
Packit Service fa4841
#endif
Packit Service fa4841
Packit Service fa4841
#endif /* WINPR_CREDENTIALS_H */