IOpcCertificateEnumerator ::GetCurrent, méthode (msopc.h)

Article
02/29/2024

Obtient la structure CERT_CONTEXT à la position actuelle de l’énumérateur.

Syntaxe

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

Paramètres

[out, retval] certificate

Pointeur vers une structure CERT_CONTEXT . Si la méthode réussit, appelez la fonction CertFreeCertificateContext pour libérer la mémoire de la structure.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code/valeur de retour	Description
S_OK	S_OK
E_POINTER	Le paramètre partReference est NULL.
OPC_E_ENUM_COLLECTION_CHANGED 0x80510050	L’énumérateur n’est pas valide, car le jeu sous-jacent a changé.
OPC_E_ENUM_INVALID_POSITION 0x80510053	L’énumérateur ne peut pas effectuer cette opération à partir de sa position actuelle.
OPC_E_DS_EXTERNAL_SIGNATURE 0x8051001E	Une relation dont la cible est une partie signature a le mode cible externe ; Les parties de signature doivent se trouver à l’intérieur du package.
OPC_E_DS_INVALID_CERTIFICATE_RELATIONSHIP 0x8051001D	Une relation de type certificat de signature numérique a le mode cible externe. Pour plus d’informations sur ce type de relation, consultez OPC.
OPC_E_DS_INVALID_RELATIONSHIP_TRANSFORM_XML 0x80510021	Un élément Transform qui indique l’utilisation de la transformation de relations et les critères de sélection de la transformation ne sont pas conformes au schéma spécifié dans l’OPC.
OPC_E_DS_MISSING_CERTIFICATE_PART 0x80510056	La partie qui contient le certificat et qui est la cible d’une relation de type certificat de signature numérique n’existe pas. Pour plus d’informations sur ce type de relation, consultez OPC.
OPC_E_DS_SIGNATURE_PROPERTY_MISSING_TARGET 0x80510045	L’élément SignatureProperty ne contient pas l’attribut Target requis.
OPC_E_UNEXPECTED_CONTENT_TYPE 0x80510005	Soit le type de contenu d’une partie diffère du type de contenu attendu (spécifié dans l’OPC, ECMA-376 Partie 2), soit le contenu de la partie ne correspond pas au type de contenu du composant.

Remarques

Si le certificat représenté par la structure CERT_CONTEXT est endommagé ou n’est pas un certificat X.509, cette méthode retourne une erreur ; en outre, la stratégie de signature utilisée par l’appelant détermine si la signature sera toujours validée. Une fois ce type d’erreur retourné, les appels à la méthode MoveNext ou MovePrevious continuent d’itérer dans l’énumérateur.

Lorsqu’un énumérateur est créé, la position actuelle précède le premier pointeur de l’énumérateur. Pour définir la position actuelle sur le premier pointeur, appelez la méthode MoveNext après la création de l’énumérateur.

Cohérence de thread

Les objets d’empaquetage ne sont pas thread-safe.

Pour plus d’informations, consultez la Prise en main avec l’API Packaging.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	msopc.h