Método IOpcCertificateEnumerator::GetCurrent (msopc.h)

Artículo
11/11/2023

Obtiene la estructura CERT_CONTEXT en la posición actual del enumerador.

Sintaxis

HRESULT GetCurrent(
  [out, retval] const CERT_CONTEXT **certificate
);

Parámetros

[out, retval] certificate

Puntero a una estructura de CERT_CONTEXT . Si el método se ejecuta correctamente, llame a la función CertFreeCertificateContext para liberar la memoria de la estructura.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código o valor devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_POINTER	El parámetro partReference es NULL.
OPC_E_ENUM_COLLECTION_CHANGED 0x80510050	El enumerador no es válido porque el conjunto subyacente ha cambiado.
OPC_E_ENUM_INVALID_POSITION 0x80510053	El enumerador no puede realizar esta operación desde su posición actual.
OPC_E_DS_EXTERNAL_SIGNATURE 0x8051001E	Una relación cuyo destino es un elemento Signature tiene el modo de destino externo; Las partes de firma deben estar dentro del paquete.
OPC_E_DS_INVALID_CERTIFICATE_RELATIONSHIP 0x8051001D	Una relación de tipo certificado de firma digital tiene el modo de destino externo. Para obtener más información sobre este tipo de relación, consulte OPC.
OPC_E_DS_INVALID_RELATIONSHIP_TRANSFORM_XML 0x80510021	Un elemento Transform que indica el uso de la transformación de relaciones y los criterios de selección de la transformación no se ajustan al esquema especificado en el OPC.
OPC_E_DS_MISSING_CERTIFICATE_PART 0x80510056	La parte que contiene el certificado y es el destino de una relación de tipo certificado de firma digital no existe. Para obtener más información sobre este tipo de relación, consulte OPC.
OPC_E_DS_SIGNATURE_PROPERTY_MISSING_TARGET 0x80510045	Falta el atributo Target necesario para el elemento SignatureProperty.
OPC_E_UNEXPECTED_CONTENT_TYPE 0x80510005	El tipo de contenido de una parte difiere del tipo de contenido esperado (especificado en OPC, ECMA-376 Part 2) o el contenido de la parte no coincide con el tipo de contenido del elemento.

Comentarios

Si el certificado representado por la estructura CERT_CONTEXT está dañado o no es un certificado X.509, este método devolverá un error; además, la directiva de firma usada por el autor de la llamada determina si la firma se seguirá validando. Una vez devuelto este tipo de error, las llamadas al método MoveNext o MovePrevious seguirán iterando por el enumerador.

Cuando se crea un enumerador, la posición actual precede al primer puntero del enumerador. Para establecer la posición actual en el primer puntero, llame al método MoveNext después de crear el enumerador.

Seguridad para subprocesos

Los objetos de empaquetado no son seguros para subprocesos.

Para más información, consulte la Introducción con la API de empaquetado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	msopc.h