Méthode IOpcDigitalSignature::GetNamespaces (msopc.h)

Article
08/25/2023

Obtient le préfixe et le mappage d’espace de noms de l’élément Signature du balisage de signature.

Syntaxe

HRESULT GetNamespaces(
  [out] LPWSTR **prefixes,
  [out] LPWSTR **namespaces,
  [out] UINT32 *count
);

Paramètres

[out] prefixes

Pointeur vers une mémoire tampon de chaînes de préfixe XML. Si la méthode réussit, appelez la fonction CoTaskMemFree pour libérer la mémoire de chaque chaîne dans la mémoire tampon, puis pour libérer la mémoire mémoire de la mémoire tampon elle-même.

[out] namespaces

Pointeur vers une mémoire tampon de chaînes d’espace de noms XML. Si la méthode réussit, appelez la fonction CoTaskMemFree pour libérer la mémoire de chaque chaîne dans la mémoire tampon, puis pour libérer la mémoire mémoire de la mémoire tampon elle-même.

[out] count

Taille des tampons de préfixes et d’espaces de noms .

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 prefixes est NULL.
E_POINTER	Le paramètre namespaces est NULL.
E_POINTER	Le paramètre count est NULL.

Notes

Les tampons de préfixes et d’espaces de noms sont mappés les uns aux autres par index.

Cette méthode alloue la mémoire utilisée par les mémoires tampons retournées dans les préfixes et espaces de noms , ainsi que les chaînes contenues dans chaque mémoire tampon.

Exemples

Le code suivant montre comment utiliser CoTaskMemFree pour libérer la mémoire des mémoires tampons et des chaînes qu’elles contiennent.

// Prepare to call GetNamespaces
LPWSTR* prefixes = NULL;
LPWSTR* namespaces = NULL;
UINT32 count = 0;

// Call to GetNamespaces succeeds
if ( SUCCEEDED( signature->GetNamespaces(&prefixes, &namespaces, &count) ) )
{
    // Process strings in prefixes and namespaces as needed for the application

    // Free memory for each string
    for (UINT32 i = 0; i < count; i++)
    {
        CoTaskMemFree(prefixes[i]);
        CoTaskMemFree(namespaces[i]);
    }
    // Free memory for the buffers
    CoTaskMemFree(prefixes);
    CoTaskMemFree(namespaces);
}

Spécifications


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