Share via

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

추가 정보

CryptCATAdminAddCatalog

CryptCATAdminReleaseContext

CryptCATAdminRemoveCatalog