IcEnroll ::acceptFilePKCS7, méthode (xenroll.h)

Article
03/13/2024

[Cette méthode n’est plus disponible à partir de Windows Server 2008 et Windows Vista.]

La méthode acceptFilePKCS7 accepte et traite un fichier qui contient un message PKCS #7 contenant un certificat. Cette méthode a d’abord été définie dans l’interface ICEnroll .

Syntaxe

HRESULT acceptFilePKCS7(
  [in] BSTR wszPKCS7FileName
);

Paramètres

[in] wszPKCS7FileName

Spécifie le nom du fichier qui contient le message PKCS #7.

Valeur retournée

VB

La valeur de retour est un HRESULT. La valeur S_OK indique la réussite. Une fois cette fonction terminée, le message PKCS #7 dans le fichier est accepté.

Remarques

Par défaut, les magasins système My, Ca, Root et Request sont utilisés pour stocker les certificats. Toutefois, vous pouvez spécifier d’autres magasins en affectant les propriétés suivantes avant d’appeler cette méthode :

La méthode acceptFilePKCS7 diffère de acceptPKCS7 uniquement en ce qu’un fichier fournit le certificat.

Exemples

HRESULT  hr;
BSTR     bstrFileName;

// Allocate a BSTR referencing an existing file, 
// for example, "myPKCS7.fil".
bstrFileName = SysAllocString(TEXT("<FILENAMEHERE>"));
if (NULL == bstrFileName)
{
    //handle error
}

// pEnroll is a previously instantiated ICEnroll interface pointer.
hr = pEnroll->acceptFilePKCS7( bstrFileName );
if (FAILED(hr))
    printf("Failed acceptFilePKCS7 - %x\n", hr );
else
	printf("Accepted PKCS #7 from file %ws successfully\n", 
	bstrFileName );

// Free BSTR when done.
if (bstrFileName)
    SysFreeString(bstrFileName);

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