IOpcSignatureCustomObjectSet ::Create, méthode (msopc.h)

Article
02/29/2024

Crée un pointeur d’interface IOpcSignatureCustomObject pour représenter un élément Object spécifique à l’application dans la signature et ajoute la nouvelle interface à l’ensemble.

Syntaxe

HRESULT Create(
  [in]          const UINT8               *xmlMarkup,
  [in]          UINT32                    count,
  [out, retval] IOpcSignatureCustomObject **customObject
);

Paramètres

[in] xmlMarkup

Mémoire tampon qui contient le balisage XML pour l’élément Object à représenter.

Ce balisage XML doit inclure les balises Object ouvrant et fermant /Object .

L’encodage du balisage contenu dans xmlMarkup sera déduit. L’inclusion d’une marque d’ordre d’octet au début de la mémoire tampon passée dans xmlMarkup est facultative.

Les encodages et les valeurs de marque d’ordre d’octet suivants sont pris en charge :

Encodage	Description	Marque d'ordre d'octet
UTF8	UTF-8	EF BB BF
UTF16LE	UTF-16, little endian	FF FE
UTF16BE	UTF-16, Big Endian	FE FF

[in] count

Taille de la mémoire tampon xmlMarkup .

[out, retval] customObject

Nouveau pointeur d’interface IOpcSignatureCustomObject qui représente l’élément Object spécifique à l’application.

Ce paramètre peut être NULL si un pointeur vers la nouvelle interface n’est pas nécessaire.

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_INVALIDARG	Le paramètre count est 0. Le paramètre xmlMarkup doit être passé un balisage XML valide.
E_POINTER	Le paramètre xmlMarkup est NULL.

Remarques

Un pointeur d’interface IOpcSignatureCustomObject permet d’accéder au balisage XML de l’élément Object qu’il représente. Pour accéder au balisage XML de l’élément Object , appelez la méthode IOpcSignatureCustomObject ::GetXml .

Lorsqu’un pointeur d’interface IOpcSignatureCustomObject est créé et ajouté à l’ensemble, l’objet qu’il représente est enregistré lors de l’enregistrement du package.

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 d’empaquetage.

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