Functie CryptUIDlgSelectCertificate

De functie CryptUIDlgSelectCertificate geeft een dialoogvenster weer waarmee een gebruiker een certificaat kan selecteren.

Syntaxis

PCCERT_CONTEXT WINAPI CryptUIDlgSelectCertificate(
  _In_  PCCRYPTUI_SELECTCERTIFICATE_STRUCT pcsc
);

Parameters

pcsc [in]

Een aanwijzer naar een CRYPTUI_SELECTCERTIFICATE_STRUCT structuur met informatie over het dialoogvenster dat moet worden weergegeven.

Retourwaarde

Een aanwijzer naar een CERT_CONTEXT structuur die het certificaat vertegenwoordigt dat door de gebruiker is geselecteerd. Wanneer u dit certificaat hebt gebruikt, moet u deze aanwijzer doorgeven aan de functie CertFreeCertificateContext om het aantal verwijzingen van de certificaatcontext te verlagen.

Als het dwFlags-lid van de pcsc-structuur niet de vlag CRYPTUI_SELECTCERT_MULTISELECT bevat, betekent een retourwaarde van NULL dat de gebruiker het dialoogvenster heeft gesloten zonder een certificaat te selecteren.

Als het dwFlags-lid van de pcsc-structuur de vlag CRYPTUI_SELECTCERT_MULTISELECT bevat, retourneert deze functie altijd NULL. De geselecteerde certificaten worden opgenomen in het certificaatarchief dat wordt vertegenwoordigd door het lid hSelectedCertStore van pcsc. Als het aantal certificaten in het archief hetzelfde is voor en na het aanroepen van CryptUIDlgSelectCertificate, heeft de gebruiker het dialoogvenster gesloten zonder certificaten te selecteren.

Remarks

Als het dwFlags-lid van de CRYPTUI_SELECTCERTIFICATE_STRUCT-structuur is ingesteld op CRYPTUI_SELECTCERT_LEGACY, wordt het verouderde dialoogvenster weergegeven. Anders wordt het huidige dialoogvenster voor certificaatselectie weergegeven.

Requirements

Zie ook

CRYPTUI_SELECTCERTIFICATE_STRUCT