Método ICspInformation::InitializeFromType (certenroll.h)

  • Artículo

El método InitializeFromType inicializa el objeto del proveedor criptográfico predeterminado.

Sintaxis

HRESULT InitializeFromType(
  [in]           X509ProviderType Type,
  [in, optional] IObjectId        *pAlgorithm,
  [in]           VARIANT_BOOL     MachineContext
);

Parámetros

[in] Type

Valor de enumeración X509ProviderType que define el tipo de proveedor.

  • Si especifica XCN_PROV_NONE y establece el parámetro pAlgorithm en un valor distinto de NULL, se usa el proveedor Cryptography API: Next Generation (CNG) predeterminado.
  • Si especifica un valor distinto de XCN_PROV_NONE y establece el parámetro pAlgorithm en NULL, se usa el proveedor de servicios criptográficos (CSP) heredado predeterminado.

[in, optional] pAlgorithm

Puntero a una interfaz IObjectId que representa un OID de algoritmo. Este parámetro es opcional y puede ser NULL. Para obtener más información, vea el parámetro Type .

[in] MachineContext

Variable VARIANT_BOOL que indica si se debe usar el equipo o el contexto de usuario para determinar el proveedor predeterminado para el tipo de proveedor especificado. Especifique VARIANT_TRUE para el equipo y VARIANT_FALSE para el usuario.

Valor devuelto

Si la función se realiza correctamente, la función devuelve S_OK.

Si se produce un error en la función, devuelve un valor HRESULT que indica el error. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Código o valor devuelto Descripción
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 El objeto ya se ha inicializado.

Comentarios

El método InitializeFromType valida el tipo especificado y lo guarda en la propiedad Type , recupera el proveedor predeterminado y establece los valores de propiedad siguientes en el objeto ICspInformation :

El método agrega los algoritmos disponibles a la colección ICspAlgorithms devuelta por la propiedad CspAlgorithms . Llame al método InitializeFromName para inicializar el objeto a partir de un nombre de CSP.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado certenroll.h
Archivo DLL CertEnroll.dll

Consulte también

ICspInformation