Compartilhar via


Função CryptCATAdminAcquireContext (mscat.h)

[A função CryptCATAdminAcquireContext está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

A função CryptCATAdminAcquireContext adquire um identificador para um contexto de administrador de catálogo. Esse identificador pode ser usado por chamadas subsequentes para as funções CryptCATAdminAddCatalog, CryptCATAdminEnumCatalogFromHash e CryptCATAdminRemoveCatalog . Essa função não tem biblioteca de importação associada. Você deve usar as funções LoadLibrary e GetProcAddress para vincular dinamicamente a Wintrust.dll.

Sintaxe

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

Parâmetros

[out] phCatAdmin

Um ponteiro para o identificador de contexto do administrador do catálogo atribuído por essa função. Quando terminar de usar o identificador, feche-o chamando a função CryptCATAdminReleaseContext .

[in] pgSubsystem

Um ponteiro para o GUID que identifica o subsistema. DRIVER_ACTION_VERIFY representa o subsistema para componentes do sistema operacional e drivers de terceiros. Esse é o subsistema usado pela maioria das implementações.

[in] dwFlags

Não usado; definido como zero.

Retornar valor

O valor retornado será TRUE se a função for bem-sucedida; FALSE se a função falhar.

Para obter informações de erro estendidas, chame a função GetLastError . Para obter uma lista completa de códigos de erro fornecidos pelo sistema operacional, consulte Códigos de erro do sistema.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mscat.h
Biblioteca Wintrust.lib
DLL Wintrust.dll

Confira também

CryptCATAdminAddCatalog

CryptCATAdminReleaseContext

CryptCATAdminRemoveCatalog