CryptCATAdminAcquireContext 함수(mscat.h)
[ CryptCATAdminAcquireContext 함수는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]
CryptCATAdminAcquireContext 함수는 카탈로그 관리자 컨텍스트에 대한 핸들을 가져옵니다. 이 핸들은 CryptCATAdminAddCatalog, CryptCATAdminEnumCatalogFromHash 및 CryptCATAdminRemoveCatalog 함수에 대한 후속 호출에서 사용할 수 있습니다. 이 함수에는 연결된 가져오기 라이브러리가 없습니다. LoadLibrary 및 GetProcAddress 함수를 사용하여 Wintrust.dll 동적으로 연결해야 합니다.
구문
BOOL CryptCATAdminAcquireContext(
[out] HCATADMIN *phCatAdmin,
[in] const GUID *pgSubsystem,
[in] DWORD dwFlags
);
매개 변수
[out] phCatAdmin
이 함수에서 할당한 카탈로그 관리자 컨텍스트 핸들에 대한 포인터입니다. 핸들 사용을 마쳤으면 CryptCATAdminReleaseContext 함수를 호출하여 핸들을 닫습니다.
[in] pgSubsystem
하위 시스템을 식별하는 GUID에 대한 포인터입니다. DRIVER_ACTION_VERIFY 운영 체제 구성 요소 및 타사 드라이버에 대한 하위 시스템을 나타냅니다. 대부분의 구현에서 사용하는 하위 시스템입니다.
[in] dwFlags
사용되지 않음; 를 0으로 설정합니다.
반환 값
함수가 성공하면 반환 값이 TRUE 이고, 함수가 실패하면 FALSE 입니다.
확장된 오류 정보는 GetLastError 함수를 호출합니다. 운영 체제에서 제공하는 오류 코드의 전체 목록은 시스템 오류 코드를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | mscat.h |
| 라이브러리 | Wintrust.lib |
| DLL | Wintrust.dll |