Méthode IEnumCERTVIEWEXTENSION ::GetName (certview.h)

Article
02/23/2024

La méthode GetName récupère le nom de l’extension actuelle dans la séquence d’énumération d’extension.

Le nom d’extension retourné est une chaîne d’identificateur d’objet (OID), comme dans L"2.5.29.31 ».

Syntaxe

HRESULT GetName(
  [out] BSTR *pstrOut
);

Paramètres

[out] pstrOut

Pointeur vers une valeur de type BSTR qui contient le nom de l’extension.

Valeur retournée

C++

Si la méthode réussit, la méthode retourne S_OK et le paramètre pstrOut est défini sur le nom de l’extension.

Pour utiliser cette méthode, créez une variable de type BSTR , définissez la variable sur NULL et transmettez l’adresse de cette variable au format pstrOut. Une fois que vous avez terminé d’utiliser le BSTR, libérez-le en appelant la fonction SysFreeString .

Si la méthode échoue, elle retourne une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

VB

La valeur de retour est une chaîne qui contient le nom de l’extension.

Remarques

Cette fonction est utilisée pour récupérer le nom de l’extension actuellement référencée par la séquence d’énumération d’extension.

Si la séquence d’énumération d’extension ne fait pas référence à une extension valide, GetName échoue. Utilisez l’une des méthodes suivantes pour parcourir l’énumération :

IEnumCERTVIEWEXTENSION ::Reset : passe à l’extension suivante dans la séquence d’énumération.
IEnumCERTVIEWEXTENSION ::Next : passe à l’extension suivante dans la séquence d’énumération.
IEnumCERTVIEWEXTENSION ::Skip : ignore un nombre spécifié d’extensions.

Exemples

BSTR  bstrExtName = NULL;

// pEnumExt is previously instantiated IEnumCERTVIEWEXTENSION object
hr = pEnumExt->GetName(&bstrExtName);
if (S_OK == hr)
    printf("Extension name is: %ws\n", bstrExtName);
else
    printf("GetName failed: %x\n", hr);

// free memory when done
if (NULL != bstrExtName)
    SysFreeString(bstrExtName);

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	certview.h (inclure Certsrv.h)
Bibliothèque	Certidl.lib
DLL	Certadm.dll