Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Met à jour atomiquement un paramètre de configuration de service qui spécifie un certificat TLS (Transport Layer Security) dans un enregistrement de configuration dans le magasin de configuration de l’API du serveur HTTP.
Syntaxe
HTTPAPI_LINKAGE ULONG HttpUpdateServiceConfiguration(
[in] HANDLE Handle,
[in] HTTP_SERVICE_CONFIG_ID ConfigId,
[in] PVOID ConfigInfo,
[in] ULONG ConfigInfoLength,
[in] LPOVERLAPPED Overlapped
);
Paramètres
[in] Handle
Réservé et doit être NULL.
[in] ConfigId
Type d’enregistrement de configuration à mettre à jour. Ce paramètre peut être l’une des valeurs suivantes de l’énumération HTTP_SERVICE_CONFIG_ID .
| Valeur ConfigId | Meaning |
|---|---|
|
Met à jour un enregistrement de certificat SSL spécifié. |
|
Met à jour un enregistrement de certificat SNI (Server Name Indication) SSL spécifié. |
|
Met à jour l’enregistrement de certificat SSL qui spécifie que Http.sys doit consulter le magasin de magasins de certificats centralisés (CCS) pour rechercher les certificats si le port reçoit une liaison TLS. Le port est spécifié par le membre KeyDesc de la structure HTTP_SERVICE_CONFIG_SSL_CCS_SET que vous passez au paramètre pConfigInfo . |
[in] ConfigInfo
Pointeur vers une mémoire tampon qui contient les données appropriées pour spécifier le type d’enregistrement à mettre à jour. Le tableau suivant montre le type de données que contient la mémoire tampon pour les différentes valeurs possibles du paramètre ConfigId .
| Valeur ConfigId | Type de données dans la mémoire tampon pConfigInfo |
|---|---|
|
|
|
structure HTTP_SERVICE_CONFIG_SSL_SNI_SET . Le nom d’hôte est « * » lorsque le magasin de certificats central SSL est interrogé et que des liaisons génériques sont utilisées et qu’un nom d’hôte pour SNI standard. |
|
structure HTTP_SERVICE_CONFIG_SSL_CCS_SET . Cette structure est utilisée pour ajouter le magasin CCS sur le port spécifié, ainsi que pour supprimer, récupérer ou mettre à jour un enregistrement CCS SSL existant. |
[in] ConfigInfoLength
Taille, en octets, de la mémoire tampon ConfigInfo .
[in] Overlapped
Réservé et doit être NULL.
Valeur retournée
Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.
Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.
| Valeur | Meaning |
|---|---|
|
L’enregistrement spécifié n’existe pas. |
|
La taille de la mémoire tampon spécifiée dans le paramètre ConfigInfoLength est insuffisante. |
|
Le paramètre ServiceHandle n’est pas valide. |
|
Un ou plusieurs des paramètres fournis sont sous une forme inutilisable. |
|
Le certificat SSL utilisé n’est pas valide. Cela peut se produire uniquement si le paramètre HttpServiceConfigSSLCertInfo est utilisé. |
|
Code d’erreur système défini dans WinError.h. |
Remarques
Les paramètres de configuration que vous mettez à jour avec HttpUpdateServiceConfiguration sont appliqués à toutes les applications API serveur HTTP sur l’ordinateur, et persistent lorsque l’API du serveur HTTP s’arrête ou lorsque l’ordinateur est redémarré.
Spécifications
| Requirement | Valeur |
|---|---|
| Client minimum requis | Windows 10, version 1703 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Aucun pris en charge |
| plateforme cible | Fenêtres |
| Header | http.h |
| Library | Httpapi.lib |
| DLL | Httpapi.dll |
Voir aussi
Fonctions de l’API serveur HTTP version 1.0
HTTP_SERVICE_CONFIG_SSL_CCS_SET
HTTP_SERVICE_CONFIG_SSL_SNI_SET