Función CryptCATAdminAcquireContext (mscat.h)

  • Artículo

[La función CryptCATAdminAcquireContext está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

La función CryptCATAdminAcquireContext adquiere un identificador para un contexto de administrador del catálogo. Este identificador se puede usar mediante llamadas posteriores a las funciones CryptCATAdminAddCatalog, CryptCATAdminEnumCatalogFromHash y CryptCATAdminRemoveCatalog . Esta función no tiene ninguna biblioteca de importación asociada. Debe usar las funciones LoadLibrary y GetProcAddress para vincular dinámicamente a Wintrust.dll.

Sintaxis

BOOL CryptCATAdminAcquireContext(
  [out] HCATADMIN  *phCatAdmin,
  [in]  const GUID *pgSubsystem,
  [in]  DWORD      dwFlags
);

Parámetros

[out] phCatAdmin

Puntero al identificador de contexto de administrador del catálogo asignado por esta función. Cuando haya terminado de usar el identificador, ciérrelo llamando a la función CryptCATAdminReleaseContext .

[in] pgSubsystem

Puntero al GUID que identifica el subsistema. DRIVER_ACTION_VERIFY representa el subsistema de componentes del sistema operativo y controladores de terceros. Este es el subsistema utilizado por la mayoría de las implementaciones.

[in] dwFlags

No utilizado; se establece en cero.

Valor devuelto

El valor devuelto es TRUE si la función se realiza correctamente; FALSE si se produce un error en la función.

Para obtener información de error extendida, llame a la función GetLastError . Para obtener una lista completa de los códigos de error proporcionados por el sistema operativo, consulte Códigos de error del sistema.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mscat.h
Library Wintrust.lib
Archivo DLL Wintrust.dll

Consulte también

CryptCATAdminAddCatalog

CryptCATAdminReleaseContext

CryptCATAdminRemoveCatalog