1/* 2 * Copyright (c) 1999-2001,2004 Apple Computer, Inc. All Rights Reserved. 3 * 4 * @APPLE_LICENSE_HEADER_START@ 5 * 6 * This file contains Original Code and/or Modifications of Original Code 7 * as defined in and that are subject to the Apple Public Source License 8 * Version 2.0 (the 'License'). You may not use this file except in 9 * compliance with the License. Please obtain a copy of the License at 10 * http://www.opensource.apple.com/apsl/ and read it before using this 11 * file. 12 * 13 * The Original Code and all software distributed under the License are 14 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER 15 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, 16 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, 17 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. 18 * Please see the License for the specific language governing rights and 19 * limitations under the License. 20 * 21 * @APPLE_LICENSE_HEADER_END@ 22 * 23 * emmspi.h -- Service Provider Interface for Elective Module Managers 24 */ 25 26#ifndef _EMMSPI_H_ 27#define _EMMSPI_H_ 1 28 29#include <Security/cssmtype.h> 30 31#ifdef __cplusplus 32extern "C" { 33#endif 34 35typedef struct cssm_state_funcs { 36 CSSM_RETURN (CSSMAPI *cssm_GetAttachFunctions) 37 (CSSM_MODULE_HANDLE hAddIn, 38 CSSM_SERVICE_MASK AddinType, 39 void **SPFunctions, 40 CSSM_GUID_PTR Guid, 41 CSSM_BOOL *Serialized); 42 CSSM_RETURN (CSSMAPI *cssm_ReleaseAttachFunctions) 43 (CSSM_MODULE_HANDLE hAddIn); 44 CSSM_RETURN (CSSMAPI *cssm_GetAppMemoryFunctions) 45 (CSSM_MODULE_HANDLE hAddIn, 46 CSSM_UPCALLS_PTR UpcallTable); 47 CSSM_RETURN (CSSMAPI *cssm_IsFuncCallValid) 48 (CSSM_MODULE_HANDLE hAddin, 49 CSSM_PROC_ADDR SrcAddress, 50 CSSM_PROC_ADDR DestAddress, 51 CSSM_PRIVILEGE InPriv, 52 CSSM_PRIVILEGE *OutPriv, 53 CSSM_BITMASK Hints, 54 CSSM_BOOL *IsOK); 55 CSSM_RETURN (CSSMAPI *cssm_DeregisterManagerServices) 56 (const CSSM_GUID *GUID); 57 CSSM_RETURN (CSSMAPI *cssm_DeliverModuleManagerEvent) 58 (const CSSM_MANAGER_EVENT_NOTIFICATION *EventDescription); 59} CSSM_STATE_FUNCS DEPRECATED_IN_MAC_OS_X_VERSION_10_7_AND_LATER, *CSSM_STATE_FUNCS_PTR DEPRECATED_IN_MAC_OS_X_VERSION_10_7_AND_LATER; 60 61typedef struct cssm_manager_registration_info { 62 /* loading, unloading, dispatch table, and event notification */ 63 CSSM_RETURN (CSSMAPI *Initialize) 64 (uint32 VerMajor, 65 uint32 VerMinor); 66 CSSM_RETURN (CSSMAPI *Terminate) (void); 67 CSSM_RETURN (CSSMAPI *RegisterDispatchTable) 68 (CSSM_STATE_FUNCS_PTR CssmStateCallTable); 69 CSSM_RETURN (CSSMAPI *DeregisterDispatchTable) (void); 70 CSSM_RETURN (CSSMAPI *EventNotifyManager) 71 (const CSSM_MANAGER_EVENT_NOTIFICATION *EventDescription); 72 CSSM_RETURN (CSSMAPI *RefreshFunctionTable) 73 (CSSM_FUNC_NAME_ADDR_PTR FuncNameAddrPtr, 74 uint32 NumOfFuncNameAddr); 75} CSSM_MANAGER_REGISTRATION_INFO DEPRECATED_IN_MAC_OS_X_VERSION_10_7_AND_LATER, *CSSM_MANAGER_REGISTRATION_INFO_PTR DEPRECATED_IN_MAC_OS_X_VERSION_10_7_AND_LATER; 76 77enum { 78 CSSM_HINT_NONE = 0, 79 CSSM_HINT_ADDRESS_APP = 1 << 0, 80 CSSM_HINT_ADDRESS_SP = 1 << 1 81}; 82 83CSSM_RETURN CSSMAPI 84ModuleManagerAuthenticate (CSSM_KEY_HIERARCHY KeyHierarchy, 85 const CSSM_GUID *CssmGuid, 86 const CSSM_GUID *AppGuid, 87 CSSM_MANAGER_REGISTRATION_INFO_PTR FunctionTable) 88 DEPRECATED_IN_MAC_OS_X_VERSION_10_7_AND_LATER; 89 90#ifdef __cplusplus 91} 92#endif 93 94#endif /* _EMMSPI_H_ */ 95