Méthode ITpmVirtualSmartCardManager ::CreateVirtualSmartCard (tpmvscmgr.h)

Article
08/26/2023

Crée un carte intelligent virtuel TPM avec les paramètres donnés.

Syntaxe

HRESULT CreateVirtualSmartCard(
  [in]           LPCWSTR                                   pszFriendlyName,
  [in]           BYTE                                      bAdminAlgId,
  [in]           const BYTE                                *pbAdminKey,
  [in]           DWORD                                     cbAdminKey,
  [in, optional] const BYTE                                *pbAdminKcv,
  [in]           DWORD                                     cbAdminKcv,
  [in, optional] const BYTE                                *pbPuk,
  [in]           DWORD                                     cbPuk,
  [in]           const BYTE                                *pbPin,
  [in]           DWORD                                     cbPin,
  [in]           BOOL                                      fGenerate,
  [in, optional] ITpmVirtualSmartCardManagerStatusCallback *pStatusCallback,
  [out]          LPWSTR                                    *ppszInstanceId,
  [out]          BOOL                                      *pfNeedReboot
);

Paramètres

[in] pszFriendlyName

Nom d’affichage du nœud lecteur smart carte. Cela s’affiche dans le Gestionnaire de périphériques, mais il ne s’agit pas du nom de lecteur tel qu’il est vu par le gestionnaire de ressources carte intelligent (SCRM).

[in] bAdminAlgId

Identificateur d’algorithme de la clé d’administration. Actuellement, pour utiliser le minidriver GIDS de boîte de réception, cette valeur doit être VSC_DEFAULT_ADMIN_ALGORITHM_ID (des triples à 3 touches avec la méthode de remplissage ISO/IEC 9797 2 en mode chaînage CBC).

[in] pbAdminKey

Pointeur vers un tableau d’octets qui contient la clé d’administration du carte intelligent virtuel à créer.

[in] cbAdminKey

Taille, en octets, du tableau d’octets pointé vers le paramètre pbAdminKey .

[in, optional] pbAdminKcv

Pointeur vers un tableau d’octets qui contient la clé case activée valeur de la clé d’administration. Clé case activée valeur est définie comme les 3 premiers octets de l’objet BLOB de sortie lors de l’utilisation de la clé d’administration pour chiffrer un bloc de zéros. Si la clé case activée valeur n’est pas fournie, il n’y aura aucune case activée d’intégrité pour la clé d’administration.

[in] cbAdminKcv

Taille, en octets, du tableau d’octets vers lequel pointe le paramètre pbAdminKcv .

[in, optional] pbPuk

Pointeur vers un tableau d’octets qui contient la valeur de la clé de déverrouillage (PUK) du carte intelligent virtuel. Il s’agit généralement d’une séquence de caractères ASCII d’une longueur minimale de 8 caractères. Si la puK n’est pas fournie, la carte intelligente virtuelle est créée sans rôle PUK et utilise à la place la réinitialisation du code confidentiel basée sur la demande/réponse via le rôle d’administrateur.

[in] cbPuk

Taille, en octets, du tableau d’octets pointé vers le paramètre pbPuk .

[in] pbPin

Pointeur vers un tableau d’octets qui contient la valeur de code confidentiel du carte intelligent virtuel. Il s’agit généralement d’une séquence de caractères ASCII d’une longueur minimale de 8 caractères et de 127 caractères maximum.

[in] cbPin

Taille, en octets, du tableau d’octets vers lequel pointe le paramètre pbPin .

[in] fGenerate

Indique si le carte intelligent virtuel doit être approvisionné avec tous les fichiers nécessaires requis par le fournisseur de solutions Cloud de base et le fournisseur de services partagés carte intelligent.

[in, optional] pStatusCallback

Pointeur vers une interface ITpmVirtualSmartCardManagerStatusCallback . Le gestionnaire de carte intelligent virtuel TPM utilise cette interface de rappel pour communiquer la progression ou l’erreur lors de la création de carte intelligentes virtuelles. Si le paramètre pStatusCallback a la valeur NULL, aucune progression n’est signalée au client avant la fin de l’opération.

[out] ppszInstanceId

Pointeur vers un pointeur vers une mémoire tampon Unicode pour recevoir l’ID instance de l’carte intelligente virtuelle créée.

[out] pfNeedReboot

Pointeur vers une valeur booléenne pour recevoir si l’opération demandée doit redémarrer l’ordinateur.

Valeur retournée

Si la méthode réussit, elle retourne S_OK.

Si la méthode échoue, elle retourne un code d’erreur Win32.

Remarques

Lorsque la méthode réussit, le paramètre ppszInstanceId pointe vers la mémoire tampon Unicode qui contient l’identificateur instance du lecteur smart carte virtuel TPM nouvellement créé. Lorsque vous avez terminé d’utiliser la mémoire tampon, l’appelant doit libérer la mémoire tampon sur le client en appelant la fonction CoTaskMemFree , comme indiqué dans les règles de gestion de la mémoire COM.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	tpmvscmgr.h
Bibliothèque	Vscmgr.lib

Voir aussi

ITpmVirtualSmartCardManager

Partager via