Méthode ICEnroll ::p ut_RequestStoreName (xenroll.h)

Article
03/13/2024

[Cette propriété n’est plus disponible depuis Windows Server 2008 et Windows Vista.]

La propriété RequestStoreName définit ou récupèreICEnroll le nom du magasin qui contient le certificat factice. Ce certificat factice, ainsi que les clés privées ajoutées, reste dans le magasin de demandes jusqu’à ce qu’une autorité de certification traite la demande et réponde avec un PKCS #7.

La valeur par défaut de cette propriété est « REQUEST ». Si la valeur par défaut ne doit pas être utilisée, cette propriété doit être définie sur le magasin à utiliser avant les appels à createPKCS10 ou createFilePKCS10 et à nouveau avant les appels à acceptPKCS7 ou acceptFilePKCS7.

Cette propriété a d’abord été définie dans l’interface ICEnroll .

Cette propriété est en lecture/écriture.

Syntaxe

HRESULT put_RequestStoreName(
  BSTR bstrName
);

Paramètres

bstrName

Valeur de retour

None

Remarques

En règle générale, la modification de la propriété RequestStoreName est effectuée uniquement dans les applications avancées. La modification de cette valeur n’est pas recommandée pour la plupart des applications.

La propriété RequestStoreName affecte le comportement des méthodes suivantes :

La possibilité de définir cette propriété est désactivée lorsque le contrôle d’inscription de certificat est exécuté en tant que contrôle scripté.

Exemples

BSTR     bstrStoreName = NULL;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer

// get the storename
hr = pEnroll->get_RequestStoreName( &bstrStoreName );
if ( FAILED ( hr ) )
    printf("Failed getting RequestStoreName - %x\n", hr );
else
    printf( "RequestStoreName: %ws\n", bstrStoreName );
// free BSTR when done
if ( NULL != bstrStoreName )
    SysFreeString( bstrStoreName );

// set the storename
// bstrNewName is a BSTR that is previously set to a valid store name
hr = pEnroll->put_RequestStoreName( bstrNewName );
if ( FAILED ( hr ) )
    printf("Failed setting RequestStoreName - %x\n", hr );
else
    printf( "RequestStoreName was set to : %ws\n", bstrNewName );

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	xenroll.h
Bibliothèque	Uuid.lib
DLL	Xenroll.dll

Partager via