Método IObjectId::InitializeFromName (certenroll.h)

  • Artículo

El método InitializeFromName inicializa el objeto a partir de un valor de enumeración CERTENROLL_OBJECTID . Este método está habilitado para web.

Sintaxis

HRESULT InitializeFromName(
  [in] CERTENROLL_OBJECTID Name
);

Parámetros

[in] Name

Valor de enumeración CERTENROLL_OBJECTID.

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
CERTSRV_E_PROPERTY_EMPTY
 No se encontró la información del OID.
CRYPT_E_UNKNOWN_ALGO
 No se reconoce el nombre del algoritmo.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 El objeto ya se ha inicializado.

Comentarios

Cada valor de CERTENROLL_OBJECTID está asociado a un identificador de objeto ASN.1. Por ejemplo, el valor XCN_OID_ECDSA_SHA1 está asociado a una cadena que contiene 1.2.840.10045.4.1. Esta es la representación decimal punteada del identificador de objeto iso(1)member-body(2)us(840)10045 signatures(4)sha1(1).

El método InitializeFromName busca en el Registro información asociada al identificador de objeto ASN.1. Si se encuentra información, el método rellena internamente una estructura de CRYPT_OID_INFO y la asocia al objeto . El método también usa la información local para inicializar, si es posible, el nombre para mostrar del objeto.

Puede llamar a las siguientes propiedades para recuperar información sobre un objeto IObjectId inicializado:

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

FriendlyName

IObjectID