Méthode IOpcSigningOptions ::GetSignatureId (msopc.h)

Article
02/29/2024

Obtient la valeur de l’attribut Id de l’élément Signature .

Syntaxe

HRESULT GetSignatureId(
  [out, retval] LPWSTR *signatureId
);

Paramètres

[out, retval] signatureId

Pointeur vers la valeur de l’attribut Id ou la chaîne vide « » s’il n’y a pas d’ID.

Valeur retournée

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

Code de retour	Description
S_OK	S_OK
E_POINTER	Le paramètre signatureId est NULL.

Remarques

Cette méthode alloue la mémoire utilisée par la chaîne retournée dans signatureId. Si la méthode réussit, appelez la fonction CoTaskMemFree pour libérer la mémoire.

L’attribut Id de l’élément Signature est facultatif.

Pour définir l’ID de signature, appelez la méthode IOpcSigningOptions ::SetSignatureId .

Pour accéder à l’ID avant la génération de la signature, appelez IOpcSigningOptions ::GetSignatureId. Pour accéder à l’ID de signature après la génération de la signature, appelez la méthode IOpcDigitalSignature ::GetSignatureId .

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